Rx Splitter

RX Library

Control Name Unit Class
RX Splitter RxSplit TRxSplitter

Description:
TRxSplitter divides the client area of a form into resizable panes. The splitter (or divisor) is between a control aligned to one of the edges of the form and the controls that fill up the rest of the client area. Give the splitter the same alignment as the control that is anchored to the edge of the form.

When the user moves the splitter, it resizes the anchored control. This, in turn, changes the client area of the form, and the controls that fill up the rest of the client area resize accordingly.

Use each control (ControlFirst ~ ControlSecond) on the form as a separate pane. After each pane is placed, place a splitter with the same alignment to allow that pane (ControlFirst) to be resized. The last pane to be placed on the form (ControlSecond) should be client-aligned, so that it resizes automatically to fill up the remaining space after all other panes are resized.


Using class TRxSplitter
Add a splitter to a form between two aligned controls to allow users to resize the controls at runtime.


Property BottomRightLimit
Declaration: BottomRightLimit: Integer;

TopLeftLimit and BottomRightLimit are the minimum sizes, in pixels, of the client area the splitter must leave on the form. Set TopLeftLimit or BottomRightLimit to provide a minimum size the splitter must leave when resizing its neighboring control. For example, if the Align property is alLeft or alRight, TopLeftLimit is the minimum width of the client area to the left of the splitter and BottomRightLimit is the minimum width of the client area to the right of the splitter. If the Align property is alTop, TopLeftLimit is the minimum height of the client area above the splitter.


Property ControlFirst
Declaration: ControlFirst: TControl;

ControlFirst specifies a first control (left or top), which can be resized by splitter. You need assign value to this property only when automatically assigned value are missed. You can also leave this property blank when ControlFirst value specified.


Property ControlSecond
Declaration: ControlSecond: TControl;

ControlSecond specifies a second control (right or bottom), which can be resized by splitter.

You need assign value to this property only when automatically assigned value are missed. You can also leave this property blank when ControlSecond value specified.


Property TopLeftLimit
Declaration: TopLeftLimit: Integer;

TopLeftLimit and BottomRightLimit are the minimum sizes, in pixels, of the client area the splitter must leave on the form. Set TopLeftLimit or BottomRightLimit to provide a minimum size the splitter must leave when resizing its neighboring control. For example, if the Align property is alLeft or alRight, TopLeftLimit is the minimum width of the client area to the left of the splitter and BottomRightLimit is the minimum width of the client area to the right of the splitter. If the Align property is alTop, TopLeftLimit is the minimum height of the client area above the splitter.


Event OnPosChanged
Declaration: OnPosChanged: TNotifyEvent;

OnPosChanged occurs after the user has retiled the form using the splitter. Write an OnPosChanged event handler to take specific action when the user finishes dragging the edge of the neighboring control using the splitter.


Type TSplitterStyle
Declaration: TSplitterStyle = (spUnknown, spHorizontalFirst, spHorizontalSecond, spVerticalFirst, spVerticalSecond);

TSplitterStyle type defines the values, internally used by the TRxSplitter component.


Index Page | About | Download
Creation Date: 4 Feb 1998 | Last Update: 16 Mar 2000