TdxNavBarNavigationPaneViewOptions.MaxVisibleGroups Property

Specifies the number of visible group headers within the Navigation Pane View.

Declaration

property MaxVisibleGroups: Integer read; write; default -1;

Property Value

Type
Integer

Remarks

In Navigation Pane Views, end-users may change the number of visible group headers by dragging the splitter or using the built-in context menu. Reducing the number of headers results in adding corresponding group icons to the overflow panel, thus end-users still have access to all the groups.

The MaxVisibleGroups property enables you to change the number of visible group headers either at design or at runtime. Set this property to -1 to display all the available group headers. Set it to 0 to hide all the group headers so that groups can only be accessed via the overflow panel. Setting this property to a positive integer results in the specified number of headers being displayed (if possible).

Note

the MaxVisibleGroups property value may exceed the number of currently visible groups. This takes place, for instance, when either you or end-users change groups’ visibility so that the number of visible groups is less than the MaxVisibleGroups property value. Thus, this property actually specifies the maximum number of group headers that can be visible at any one time.

The default value of the MaxVisibleGroups property is -1.