Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
You can use a CheckBox in the user interface (UI) of your application to represent options that a user can select or clear. You can use a single check box or you can group two or more check boxes.
The following graphic shows the different states of a CheckBox.
Styles and templates
You can modify the default ControlTemplate to give the CheckBox control a unique appearance. For more information, see What are styles and templates? and How to create a template for a control.
Content property
The content property for the CheckBox control is Content. Use this property to specify the text or content that appears next to the checkbox.
Parts
The CheckBox control doesn't define any template parts.
Visual states
The following table lists the visual states for the CheckBox control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Normal | CommonStates | The control is in its normal state. |
| MouseOver | CommonStates | The mouse is over the control. |
| Pressed | CommonStates | The control is pressed. |
| Disabled | CommonStates | The control is disabled. |
| Focused | FocusStates | The control has keyboard focus. |
| Unfocused | FocusStates | The control doesn't have keyboard focus. |
| Checked | CheckStates | The control is checked. |
| Unchecked | CheckStates | The control is unchecked. |
| Indeterminate | CheckStates | The control is in an indeterminate state. |
| Valid | ValidationStates | The control is valid and has no validation errors. |
| InvalidFocused | ValidationStates | The control has a validation error and has keyboard focus. |
| InvalidUnfocused | ValidationStates | The control has a validation error but doesn't have keyboard focus. |
See also
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
.NET Desktop feedback