SizeMode Property
This property determines how the Size property is used to determine the actual size of a split.
split.SizeMode= value
Read/Write at run time and design time.
Property applies to Split object.
Values
|
Design Time |
Run Time |
|
0 - Scalable (default) |
dblScalable |
|
1 - Exact |
dblExact |
|
2 - Number of Columns |
dblNumberOfColumns |
If set to 0 - Scalable (the default), then the value returned by the Size property is an integer indicating the relative size of the split with respect to other scalable splits. For example, if a control contains 3 scalable splits with Size properties equal to 1, 2, and 3, then the size of each split would be 1/6, 1/3, and 1/2 of the total control width, respectively.
If set to 1 - Exact, then the value returned by the Size property is a floating point number indicating the exact size of the split in terms of the coordinate system of the control's container. This setting allows you to fix the size of the split so that it always has the same width, even if new splits are added or existing splits are removed.
If set to 2 - Number of Columns, then the value returned by the Size property is an integer indicating the number of columns displayed in the split, and the split will adjust its width to display the number of full columns specified by the Size property. For example, if Size is set to 2, and the user scrolls the split horizontally, then the width of the split will change so that 2 full columns are displayed, regardless of how wide the columns are.
Note: Consider a control containing both scalable splits and splits with a fixed number of columns. If a split with a fixed number of columns is scrolled horizontally, the total width remaining for the scalable splits may change because control columns are generally of different widths. However, the ratios of the sizes of the scalable splits remain the same as specified by their Size properties.
Note that when there is only one split (the control's default behavior), the split spans the entire width of the control, the SizeMode property is always 0 - dblScalable, and the Size property is always 1. Setting either of these properties has no effect when there is only one split. If there are multiple splits, and you then remove all but one, the SizeMode and Size properties of the remaining split automatically revert to 0 and 1, respectively.
See Also