Skip to main content
A newer version of this page is available. .

Active Group

The active group applies only to Side Bar Views which display the contents of a single group at a time. When a user clicks a group header, the group is automatically activated. You can determine the currently active group via the ActiveGroup property. The ActiveGroupIndex property allows you to get/set the active group at design and runtime.

For Explorer Bar Views, the active group has different uses: it is not changed automatically as a result of end-user manipulations such as clicking the group header or its contents. It is only used for display purposes. That is, you can make a specific group active and then apply a distinct style for this group via the NavBar control’s OptionsStyle.DefaultStyles.GroupHeaderActive or the group’s CustomStyles.HeaderActive properties. Additionally, you can specify the hot-tracked and pressed header styles for active groups using the NavBar control’s OptionsStyle.DefaultStyles.GroupHeaderActiveHottracked and OptionsStyle.DefaultStyles.GroupHeaderActivePressed properties or the group’s CustomStyles.HeaderActiveHotTracked and CustomStyles.HeaderActivePressed properties. The specified style settings are used only if the control’s OptionsView.ExplorerBar.ShowSpecialGroup property is set to True.

Handle the NavBar control’s OnActiveGroupChanged and OnActiveGroupChanging events to respond to changing the currently active group and prohibit certain groups from being activated.

See Also