TdxDockingController.ActiveDockControl Property

Specifies the currently active dock control.

Declaration

property ActiveDockControl: TdxCustomDockControl read; write;

Property Value

Type
TdxCustomDockControl

Remarks

Assign a dock control to this property to make it active. Alternatively, call the dock control’s Activate method.

The active control has the following points to note:

• It is painted differently from all other controls in most of the view styles. The current view style is specified by the docking manager’s LookAndFeel property.

• It is not hidden if its auto hide feature is enabled and the mouse cursor is outside its area. See the TdxCustomDockControl.AutoHide property description for details on the auto hide feature.

You can handle the docking manager’s OnActiveDockControlChanged event or the dock control’s OnActivate event to perform actions when a control becomes active.

Having access to the active control provides additional docking management abilities. For instance, you can provide shortcuts to perform actions on the control currently active.

End-users can activate controls by clicking them or the controls residing within them. Also, a control is activated if it is docked to other controls provided that the doActivateAfterDocking option is enabled. This option can be accessed via the docking manager’s Options property.

Note

if a control contained within a tab container is activated either by assigning the ActiveDockControl property or by calling the control’s Activate method, its owning tab container actually becomes the active control. The assigned control is selected then within its tab container. If a floating control is activated, its float form automatically becomes the topmost visible.