Check Box

The Check Box is a control the user can click to provide input to an application. The control provides a toggle state that is represented visually.

• Details
• Check Box Properties
• Related topics

Details

The Check Box does not support a tertiary, or indeterminate, state.

The following screen shot illustrates the Ribbon Check Box element.

Check Box Properties

The Ribbon framework defines a collection of property keys for the Check Box control.

Typically, a Check Box property is updated in the ribbon UI by invalidating the Command associated with the control through a call to the IUIFramework::InvalidateUICommand method. The invalidation event is handled, and the property updates defined, by the IUICommandHandler::UpdateProperty callback method.

The IUICommandHandler::UpdateProperty callback method is not executed, and the application queried for an updated property value, until the property is required by the framework. For example, when a tab is activated and a control revealed in the ribbon UI, or when a tooltip is displayed.

Note

In some cases, a property can be retrieved through the IUIFramework::GetUICommandProperty method and set with the IUIFramework::SetUICommandProperty method.

The following table lists the property keys that are associated with the Check Box control.

Property Key	Notes
UI_PKEY_BooleanValue	Supports IUIFramework::GetUICommandProperty and IUIFramework::SetUICommandProperty. Note: If the Command associated with the control is invalidated through a call to IUIFramework::InvalidateUICommand, the framework queries this property when UI_INVALIDATIONS_VALUE is passed as the value of flags.
UI_PKEY_Enabled	Supports IUIFramework::GetUICommandProperty and IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip	Can only be updated through invalidation.
UI_PKEY_Label	Can only be updated through invalidation.
UI_PKEY_LabelDescription	Can only be updated through invalidation.
UI_PKEY_LargeHighContrastImage	Can only be updated through invalidation.
UI_PKEY_LargeImage	Can only be updated through invalidation.
UI_PKEY_SmallHighContrastImage	Can only be updated through invalidation.
UI_PKEY_SmallImage	Can only be updated through invalidation.
UI_PKEY_TooltipDescription	Can only be updated through invalidation.
UI_PKEY_TooltipTitle	Can only be updated through invalidation.

Related topics

Windows Ribbon Framework Control Library

CheckBox markup element