Export (0) Print
Expand All

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

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

The following screen shot illustrates the Ribbon Check Box element.

Screen shot of a CheckBox control in the Microsoft Paint Ribbon.

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 KeyNotes
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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft