TdxCustomDockControl.OnEndDocking Event

Fires immediately after a dragging operation on a dock control has been finished.

Declaration

property OnEndDocking: TdxEndDockingEvent read; write;

Remarks

Handle the OnEndDocking event to perform specific actions when a dragging or docking operation on a dock control is finished. For instance, if you perform some operations in the OnStartDocking event handler, the OnEndDocking event can be used to perform any necessary cleanup. Also, you can use the OnStartDocking event to save settings of controls residing on panels. This may be required since controls may lose settings when their underlying window is recreated, which takes place when performing docking operations. For instance, the focused item in list view controls is reset in such cases. The OnEndDocking event can be used then to restore those saved settings.

The Sender parameter identifies the control on which the operation has been performed. The Zone parameter specifies the dock zone to which the control has been docked. If the control has been made to float or is simply dragged from one floating position to another, this parameter returns nil. Otherwise, you can use settings of the dock zone to obtain information about the docking operation performed. The Owner and DockType properties can be used, for instance, to determine the target dock control and the docking type.

The X and Y parameters specify the mouse pointer coordinates at the moment dragging or docking was completed.