3.4 KiB
title, ms.date, helpviewer_keywords, ms.assetid
| title | ms.date | helpviewer_keywords | ms.assetid | ||||||
|---|---|---|---|---|---|---|---|---|---|
| CheckBox Styles and Templates | 03/30/2017 |
|
bfdaec96-d101-4d3d-864d-c27e6b621d03 |
CheckBox Styles and Templates
This topic describes the styles and templates for the xref:System.Windows.Controls.CheckBox 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.
CheckBox Parts
The xref:System.Windows.Controls.CheckBox control does not have any named parts.
CheckBox States
The following table lists the visual states for the xref:System.Windows.Controls.CheckBox control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Normal | CommonStates | The default state. |
| MouseOver | CommonStates | The mouse pointer is positioned over the control. |
| Pressed | CommonStates | The control is pressed. |
| Disabled | CommonStates | The control is disabled. |
| Focused | FocusStates | The control has focus. |
| Unfocused | FocusStates | The control does not have focus. |
| Checked | CheckStates | xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A is true. |
| Unchecked | CheckStates | xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A is false. |
| Indeterminate | CheckStates | xref:System.Windows.Controls.Primitives.ToggleButton.IsThreeState%2A is true, and xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A is null. |
| 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. |
| InvalidUnfocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control has focus. |
| InvalidFocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control does not have focus. |
CheckBox ControlTemplate Example
The following example shows how to define a xref:System.Windows.Controls.ControlTemplate for the xref:System.Windows.Controls.CheckBox control.
[!code-xamlControlTemplateExamples#CheckBox]
The preceding example uses one or more of the following resources.
[!code-xamlControlTemplateExamples#Resources]
For the complete sample, see Styling with ControlTemplates Sample.