3.5 KiB
title, ms.date, helpviewer_keywords, ms.assetid
| title | ms.date | helpviewer_keywords | ms.assetid | ||||||
|---|---|---|---|---|---|---|---|---|---|
| ToggleButton Styles and Templates | 03/30/2017 |
|
54f23f30-4bcb-4f09-8ce4-376a13a255a1 |
ToggleButton Styles and Templates
This topic describes the styles and templates for the xref:System.Windows.Controls.Primitives.ToggleButton 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.
ToggleButton Parts
The xref:System.Windows.Controls.Primitives.ToggleButton control does not have any named parts.
ToggleButton States
The following table lists the visual states for the xref:System.Windows.Controls.Primitives.ToggleButton 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. |
| 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. |
Note
If the Indeterminate visual state does not exist in your control template, then the Unchecked visual state will be used as default visual state.
ToggleButton ControlTemplate Example
The following example shows how to define a xref:System.Windows.Controls.ControlTemplate for the xref:System.Windows.Controls.Primitives.ToggleButton control.
[!code-xamlControlTemplateExamples#ToggleButton]
The preceding example uses one or more of the following resources.
[!code-xamlControlTemplateExamples#Resources]
For the complete sample, see Styling with ControlTemplates Sample.