Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCustomDockControl.OnStartDocking Event

In This Article

Fires when a docking operation starts.

#Declaration

Delphi
property OnStartDocking: TdxStartDockingEvent read; write;

#Remarks

End-users can perform docking operations by pressing the dock control’s caption with the mouse and dragging it. Once the dragging operation starts, the OnStartDocking event fires. Handle it if you need to perform actions each time the end-user starts to dock a control. If the actions performed require any cleanup, handle the OnEndDocking event.

The OnStartDocking event can be used, for instance, to store settings of control residing in panels. This is useful, since controls may lose their settings when the underlying window is recreated, which takes place when performing docking operations. The OnEndDocking event should be handled then to restore those saved settings.

The Sender parameter identifies the control being dragged. The X and Y parameters identify the current screen coordinates of the mouse pointer.

Note

the OnStartDocking event is not raised if docking the control is via code.

See Also