Edit

Tab Group

  • Article

A Tab Group is a contextual control that is hidden or displayed at run time, based on a document or workspace state. The Tab Group contains a set of context-related Tab controls.

Details

Typically, a Tab Group is displayed during specific document or workspace states, such as when a user selects a particular object type. For example, the selection of an image contained in the header of a table might require various contextual tabs to be displayed that expose both table and image functionality.

Important

A Tab Group does not support application modes. However, the individual Tab controls within a Tab Group may.

 

The following screen shot shows a contextual Tab from Windows 7 Paint.

screen shot that shows a contextual tab control.

Tab Group Properties

The Ribbon framework defines a collection of property keys for the Tab Group control.

Typically, a Tab Group 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 Tab Group control.

Property Key Notes
UI_PKEY_ContextAvailable 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_TooltipDescription Can only be updated through invalidation.
UI_PKEY_TooltipTitle Can only be updated through invalidation.

 

Windows Ribbon Framework Control Library

TabGroup markup element