5.7 KiB
title, description, ms.date, helpviewer_keywords, ms.assetid
| title | description | ms.date | helpviewer_keywords | ms.assetid | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ComboBox Styles and Templates | Learn about styles and templates for the Windows Presentation Foundation ComboBox control. Modify the ControlTemplate to give the control a unique appearance. | 03/30/2017 |
|
b0662fa1-16d7-4320-b26b-c1804e565a44 |
ComboBox Styles and Templates
This topic describes the styles and templates for the xref:System.Windows.Controls.ComboBox control. You can modify the default xref:System.Windows.Controls.ControlTemplate to give the control a unique appearance. For more information, see Create a template for a control.
ComboBox Parts
The following table lists the named parts for the xref:System.Windows.Controls.ComboBox control.
| Part | Type | Description |
|---|---|---|
| PART_EditableTextBox | xref:System.Windows.Controls.TextBox | Contains the text of the xref:System.Windows.Controls.ComboBox. |
| PART_Popup | xref:System.Windows.Controls.Primitives.Popup | The drop-down that contains the items in the combo box. |
When you create a xref:System.Windows.Controls.ControlTemplate for a xref:System.Windows.Controls.ComboBox, your template might contain an xref:System.Windows.Controls.ItemsPresenter within a xref:System.Windows.Controls.ScrollViewer. (The xref:System.Windows.Controls.ItemsPresenter displays each item in the xref:System.Windows.Controls.ComboBox; the xref:System.Windows.Controls.ScrollViewer enables scrolling within the control). If the xref:System.Windows.Controls.ItemsPresenter is not the direct child of the xref:System.Windows.Controls.ScrollViewer, you must give the xref:System.Windows.Controls.ItemsPresenter the name, ItemsPresenter.
ComboBox States
The following table lists the states for the xref:System.Windows.Controls.ComboBox control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Normal | CommonStates | The default state. |
| Disabled | CommonStates | The control is disabled. |
| MouseOver | CommonStates | The mouse pointer is over the xref:System.Windows.Controls.ComboBox control. |
| Focused | FocusStates | The control has focus. |
| Unfocused | FocusStates | The control does not have focus. |
| FocusedDropDown | FocusStates | The drop-down for the xref:System.Windows.Controls.ComboBox has focus. |
| Valid | ValidationStates | The control uses the xref:System.Windows.Controls.Validation class and the xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is false. |
| InvalidFocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true and the control has focus. |
| InvalidUnfocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true and the control does not have focus. |
| Editable | EditStates | The xref:System.Windows.Controls.ComboBox.IsEditable%2A property is true. |
| Uneditable | EditStates | The xref:System.Windows.Controls.ComboBox.IsEditable%2A property is false. |
ComboBoxItem Parts
The xref:System.Windows.Controls.ComboBoxItem control does not have any named parts.
ComboBoxItem States
The following table lists the states for the xref:System.Windows.Controls.ComboBoxItem control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Normal | CommonStates | The default state. |
| Disabled | CommonStates | The control is disabled. |
| MouseOver | CommonStates | The mouse pointer is over the xref:System.Windows.Controls.ComboBoxItem control. |
| Focused | FocusStates | The control has focus. |
| Unfocused | FocusStates | The control does not have focus. |
| Selected | SelectionStates | The item is currently selected. |
| Unselected | SelectionStates | The item is not selected. |
| SelectedUnfocused | SelectionStates | The item is selected, but does not have focus. |
| Valid | ValidationStates | The control uses the xref:System.Windows.Controls.Validation class and the xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is false. |
| InvalidFocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true and the control has focus. |
| InvalidUnfocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true and the control does not have focus. |
ComboBox ControlTemplate Example
The following example shows how to define a xref:System.Windows.Controls.ControlTemplate for the xref:System.Windows.Controls.ComboBox control and associated types.
[!code-xamlControlTemplateExamples#ComboBox]
The preceding example uses one or more of the following resources.
[!code-xamlControlTemplateExamples#Resources]
For the complete sample, see Styling with ControlTemplates Sample.