TcxCustomSplitter.OnBeforeOpen Event

Enables you to stop the splitter from being opened.

Declaration

property OnBeforeOpen: TBeforeOpenHotZoneEvent read; write;

Remarks

Closed splitters can be opened either by end-users or via code. End-users need to click the hot zone to do this. Open the splitter programmatically by using the OpenSplitter method or the State property. All these actions raise the OnBeforeOpen event before the splitter is actually opened. Handle this event to prevent the splitter expanding depending on your conditions. If splitter opening should not occur, set the AllowOpen parameter to False. This parameter’s value is True by default.

You can specify a new size for the bound control whose size is affected by the splitter. To modify the control’s Height or Width property, set the NewSize parameter to a new value. The splitter’s type (vertical or horizontal, determined by the AlignSplitter property value) determines which property is changed. The default value of the NewSize parameter indicates the control’s size value at the moment the OnBeforeOpen event is fired.

The Sender parameter specifies the splitter control to be opened.