[Overview][Types][Classes][Procedures and functions][Index] | Reference for unit 'ExtCtrls' (#lcl)

# TSplitter

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

TSplitter is a vertical or horizontal bar placed on a panel or form to separate sub-panels functionally.

## Declaration

Source position: extctrls.pp line 437

`type TSplitter = class(TCustomSplitter)`
`published`
`property Align: TAlign;` |  | Specifies the aligned edge for the splitter within its Parent and relative to ResizeControl.
`property Anchors: TAnchors;` |  | The set of anchor definitions for this control.
`property AutoSnap: Boolean;` |  | AutoSnap automatically moves the splitter to the zero position when split size becomes smaller than the value in MinSize.
`property Beveled: Boolean;` |  | Indicates whether the edges of the splitter bar are beveled.
`property Color: TColor;` |  | The background color for the control.
`property Constraints: TSizeConstraints;` |  | Contains the minimum and maximum Width and Height for the control.
`property Cursor: TCursor;` |  | The shape for the mouse pointer when the control is dragged.
`property DoubleBuffered: Boolean;` |  | When enabled, it reduces flicker when the control is painted.
`property Height: Integer;` |  | The vertical size for the control.
`property MinSize: Integer;` |  | Minimum size for either of the anchored controls on opposing sides of the splitter.
`property ParentColor: Boolean;` |  | Use the Color from the Parent control, when enabled.
`property ParentDoubleBuffered: Boolean;` |  | Value for the DoubleBuffered property in a Parent control.
`property ParentShowHint: Boolean;` |  | If True, the value of ShowHint for the control will be the same as the one from the Parent. Default is True.
`property PopupMenu: TPopupMenu;` |  | A context-sensitive menu that pops up when the right mouse button is clicked over this control.
`property ResizeAnchor: TAnchorKind;` |  | Indicates the orientation and alignment for the splitter control.
`property ResizeStyle: TResizeStyle;` |  | Display style used when the splitter control is moved.
`property ShowHint: Boolean;` |  | Enables Hint display for the control.
`property Visible: Boolean;` |  | Allows the control, and all of its children, to be displayed or hidden.
`property Width: Integer;` |  | The horizontal size for the control.
`property OnCanOffset: TCanOffsetEvent;` |  | Event handler signalled to calculate the offset when the splitter is dragged, and to accept or reject the offset value.
`property OnCanResize: TCanResizeEvent;` |  | Event handler signalled to determine if the splitter control can be resized / dragged / moved.
`property OnChangeBounds: TNotifyEvent;` |  | Event handler signalled when the Bounds for the control have been changed.
`property OnMoved: TNotifyEvent;` |  | Event handler signalled when the splitter has been dragged / moved.
`property OnMouseWheel: TMouseWheelEvent;` |  | Event handler for mouse wheel turned.
`property OnMouseWheelDown: TMouseWheelUpDownEvent;` |  | Event handler signalled for a downward movement of the mouse wheel.
`property OnMouseWheelUp: TMouseWheelUpDownEvent;` |  | Event handler signalled for an upward movement of the mouse wheel.
`property OnMouseWheelHorz: TMouseWheelEvent;` |  | Event handler signalled for a horizontal movement of the mouse wheel.
`property OnMouseWheelLeft: TMouseWheelUpDownEvent;` |  | Event handler signalled for a leftward movement of the mouse wheel.
`property OnMouseWheelRight: TMouseWheelUpDownEvent;` |  | Event handler signalled for a rightward movement of the mouse wheel.
`property OnPaint: TNotifyEvent;` |  | Event handler signalled to paint the control.
`end;`

## Inheritance

`TSplitter` |  | TSplitter is a vertical or horizontal bar placed on a panel or form to separate sub-panels functionally.
`TCustomSplitter` |  | TCustomSplitter is the base type for TSplitter.
`TCustomControl` |  | The base class for windowed controls which paint themselves.
`TWinControl` |  | Implements a windowed control which can contain other child controls.
`TControl` |  | The base class for visible controls.
`TLCLComponent` |  | The base class for LCL components which have an associated widget.
`TComponent`
?
`TObject`

## Description

TSplitter is a vertical or horizontal bar that can be placed on a panel or form, to separate sub-panels functionally and allow re-sizing of the sub-panels.

The splitter extends for the full height (if vertical) or full width (if horizontal) of the parent control (form or panel) and is anchored to the edges; its position along the length or height of the parent is determined by the programmer or user by moving the whole control with the mouse, and its size can be adjusted using the sizing bars and with the ResizeAnchor property.

## See also

How to use StdCtrls, ComCtrls or ExtCtrls. |  | How to use StdCtrls, ComCtrls or ExtCtrls.