Resizing Operations
- 2 minutes to read
This topic provides information on how end-users can perform resizing operations on dock controls. Also, it lists topics that give additional information about how such operations can be controlled via code.
Basically, resizing operations are dragging operations. When a dock control is floating, it can be resized by dragging the borders or corners of the float form.
When controls are docked to an edge of a dock site (or layout site), you can resize them by dragging their edges. Note that the control is not resized immediately when dragging the edge. A bar indicating the edge’s potential position is painted when dragging. The control changes its size when dropped. The image below shows an example.
Note
the bar indicating the edge’s potential position can be painted in a custom manner. Please refer to the Docking Frame and Resizing Bar Custom Painting topic for details.
You can also use the same technique to resize dock controls when they comprise side containers.
When resizing dock controls that are docked to a site or comprise a side container, the OnCanResize event is raised. You can handle this event to specify whether resizing to the current potential position is allowed. This can be used to specify the maximum or minimum sizes of the dock control, the resizing step, etc.
Also, dock controls provide a number of events that fire when starting or finishing the resizing process and fire repeatedly when resizing. However, not all these events fire for dock controls when they are resized as the result of resizing the owning float form. Please refer to the Controlling Resizing Operations topic for details and code examples.