TdxDockingManager.OnCreateFloatSite Event

This event fires immediately after a float site has been created.

Declaration

property OnCreateFloatSite: TdxCreateFloatSiteEvent read; write;

Remarks

When changing the state of a dock control to floating, its underlying float site is created. This float site fills the client area of the float form in order to accommodate the dock control. This is required since dock controls such as panels, tab containers and side containers cannot reside directly on forms.

The OnCreateFloatSite event fires each time the underlying float site is created for any of the dock controls in the application. You can handle this event to perform common initialization of float sites. Note, however, that if you only need to change default values of float sites’ properties, you can use the DefaultFloatSiteProperties property instead. Thus, the OnCreateFloatSite event should be handled if you need to apply different settings for float sites created or if you simply need to respond to making dock controls floating. Note that you can also respond to making individual dock controls floating or for creating their float sites. Handle the OnCreateFloatSite or OnMakeFloating events of a dock control for this purpose.

The Sender parameter of the event identifies the dock control whose underlying float site is created. Use this parameter to determine the control whose state has been changed to floating. The AFloatSite parameter returns the created float site.

Note

dock controls can be made floating either by performing docking operations on them or by calling their MakeFloating method.