• csharp
• vb
• xaml

Inheritance Hierarchy

System.Object
System.Windows.DependencyObject
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.ItemsControl
System.Windows.Controls.Primitives.Selector
System.Windows.Controls.ComboBox

Syntax

'Declaration
<TemplateVisualStateAttribute(Name := "InvalidUnfocused", GroupName := "ValidationStates")> _
<TemplateVisualStateAttribute(Name := "InvalidFocused", GroupName := "ValidationStates")> _
<TemplatePartAttribute(Name := "ContentPresenter", Type := GetType(ContentPresenter))> _
<TemplatePartAttribute(Name := "Popup", Type := GetType(Popup))> _
<TemplatePartAttribute(Name := "ContentPresenterBorder", Type := GetType(FrameworkElement))> _
<TemplatePartAttribute(Name := "DropDownToggle", Type := GetType(ToggleButton))> _
<TemplatePartAttribute(Name := "ScrollViewer", Type := GetType(ScrollViewer))> _
<TemplateVisualStateAttribute(Name := "Normal", GroupName := "CommonStates")> _
<TemplateVisualStateAttribute(Name := "MouseOver", GroupName := "CommonStates")> _
<TemplateVisualStateAttribute(Name := "Disabled", GroupName := "CommonStates")> _
<TemplateVisualStateAttribute(Name := "Unfocused", GroupName := "FocusStates")> _
<TemplateVisualStateAttribute(Name := "Focused", GroupName := "FocusStates")> _
<TemplateVisualStateAttribute(Name := "FocusedDropDown", GroupName := "FocusStates")> _
<TemplateVisualStateAttribute(Name := "Valid", GroupName := "ValidationStates")> _
Public Class ComboBox _
 Inherits Selector

[TemplateVisualStateAttribute(Name = "InvalidUnfocused", GroupName = "ValidationStates")]
[TemplateVisualStateAttribute(Name = "InvalidFocused", GroupName = "ValidationStates")]
[TemplatePartAttribute(Name = "ContentPresenter", Type = typeof(ContentPresenter))]
[TemplatePartAttribute(Name = "Popup", Type = typeof(Popup))]
[TemplatePartAttribute(Name = "ContentPresenterBorder", Type = typeof(FrameworkElement))]
[TemplatePartAttribute(Name = "DropDownToggle", Type = typeof(ToggleButton))]
[TemplatePartAttribute(Name = "ScrollViewer", Type = typeof(ScrollViewer))]
[TemplateVisualStateAttribute(Name = "Normal", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "MouseOver", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "Disabled", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "Unfocused", GroupName = "FocusStates")]
[TemplateVisualStateAttribute(Name = "Focused", GroupName = "FocusStates")]
[TemplateVisualStateAttribute(Name = "FocusedDropDown", GroupName = "FocusStates")]
[TemplateVisualStateAttribute(Name = "Valid", GroupName = "ValidationStates")]
public class ComboBox : Selector

<ComboBox .../>

Constructors

Top

Properties

Top

Methods

Top

Events

Top

Fields

Top

Explicit Interface Implementations

Top

Remarks

The text box either displays the current selection or is empty if there is no selected item. The following illustration shows a combo box control.

Silverlight ComboBox Control

ComboBox is an ItemsControl, which means it has an associated item container, ComboBoxItem, which contains individual pieces of content in the control. A ComboBoxItem is created for each item in a collection and can be retrieved, whether or not you create it explicitly. You can retrieve ComboBoxItem container objects by using the ItemContainerGenerator property associated with the ComboBox control. You populate the ComboBox by using the Items or ItemsSource properties. For more information, see Control Content Models.

You can retrieve the combo box's selected item by using the SelectedItem property, or retrieve the index of the selected item by using the SelectedIndex property.

Customizing the ComboBox Control

Examples

The following example demonstrates binding a combo box to a collection of FontFamily objects.

Run this sample

Public Sub New()
 MyBase.New()
 InitializeComponent()
 Dim fonts As New ObservableCollection(of FontFamily) 
 fonts.Add(New FontFamily("Arial"))
 fonts.Add(New FontFamily("Courier New"))
 fonts.Add(New FontFamily("Times New Roman"))
 FontsCombo.DataContext = fonts
End Sub

 public Page()
 {
 InitializeComponent();
 ObservableCollection<FontFamily> fonts = new ObservableCollection<FontFamily>();
 fonts.Add(new FontFamily("Arial"));
 fonts.Add(new FontFamily("Courier New"));
 fonts.Add(new FontFamily("Times New Roman"));
 FontsCombo.DataContext = fonts;
}

<ComboBox x:Name="FontsCombo" Height="20" Width="150" ItemsSource="{Binding}" />

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Other Resources