TcxCustomGrid.ActiveLevel Property

Specifies the root grid level which is currently active.

Declaration

property ActiveLevel: TcxGridLevel read; write;

Property Value

Type
TcxGridLevel

Remarks

The grid control enables you to display several Views at one hierarchy level. This takes place, for instance, in master-detail layouts when a master row has several detail Views. Moreover, the grid control is capable of displaying several Views at the root level of the hierarchy. These Views can be bound to the datasets which are not related to each other (compare with detail Views, which are bound to the same master record).

The collection of root levels can be accessed via the Levels property of the grid control. Use this property to access individual levels represented by TcxGridLevel objects. Assigning one of these objects to the ActiveLevel property makes a specified grid level active.

End-users can navigate through root grid levels using special tabs. These can be made visible by setting the RootLevelOptions.DetailTabsPosition property to dtpTop or dtpLeft. You must use the Caption property of TcxGridLevel objects to specify the tab captions corresponding to particular grid levels. To determine the currently active grid level and access its properties, use the ActiveLevel property.

The image below displays the grid control containing two root grid levels. The Customers level is currently active.