TdxCustomDockControl.Activate Method

Activates the current dock control.

Declaration

procedure Activate; virtual;

Remarks

Call the Activate method to activate the current dock control. Alternatively, you can change the docking controller’s ActiveDockControl property. The controller can be obtained using the dxDockController function call.

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 AutoHide property description for details on the auto hide feature.

Handle the control’s OnActivate event or the dock control’s OnActivate event to perform additional actions when the control is activated.

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.