TdxBarItemLink.ViewLevels Property

Specifies visual identifiers for the current item link.

Declaration

property ViewLevels: TdxBarItemViewLevels read; write; default dxBarItemAllViewLevels;

Property Value

Type	Default
TdxBarItemViewLevels	dxBarItemAllViewLevels

Remarks

With the ViewLevels property, you can specify a range of possible identifiers for an item link. Since a toolbar can be dynamically laid out, an item link can be represented by one specific identifier at any point in time. You can constrain this range to only one identifier, if required. In this instance, an item link will be depicted by this identifier in all layout states. In Ribbon Status Bars, item links can be represented by only one identifier.

The following image shows a transition from one item link identifier to another (when a toolbar is narrowed gradually):

At design time, you can change the ViewLevels property using the corresponding option within the customizing popup menu.

Note

The ViewLevels property’s default dxBarItemAllViewLevels value means that one of the following options can be applied to the item link based upon the space it occupies: ivlLargeIconWithText, ivlLargeControlOnly, ivlSmallIconWithText, ivlSmallIcon, ivlControlOnly. Because the ivlLargeIconWithText and ivlLargeControlOnly options apply to multi-line editors only, the corresponding items will be displayed in the customizing popup menu only for these controls. By default, the ivlLargeIconWithText and ivlLargeControlOnly options are enabled for the RadioGroup, CheckGroup, Image, Memo, and Rich editors embedded into the Ribbon via TcxBarEditItem. In addition, the ivlLargeControlOnly option is enabled for the TdxBarControlContainerItem items that host controls whose height exceeds half of a bar control’s height.

The default value of the ViewLevels property is dxBarItemAllViewLevels.