TdxDockSite.AutoSize Property

Specifies whether the dock site is automatically resized to fit the size of dock controls placed on it.

Declaration

property AutoSize: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

By default, when docking a control to a dock site, the control’s size is changed to fit the dock site’s size. If the control is docked to the top or bottom edge, its width is modified. If it is docked to the left or right edge, the control is resized vertically. Finally, if docked to fill the entire dock site’s area, the control is resized in both directions.

Sometimes, you may need to change this default behavior. This can be done by setting the AutoSize property to True. In this case, dock sites are resized to fit the dock control placed on it. This enables you, for instance, to create an extremely narrow dock site and align it to the left or right edge of the form. When a control is docked to the site, it will be automatically resized horizontally to fit the docked control’s width. Note that when enabling the auto hide feature for the docked control, the site will revert to its original size. Thus, it will never occupy any unused space.

Note

you cannot set the AutoSize property to True, when the dock site already has control(s) docked to it.

The default value of the AutoSize property is False.