4D Doc Center : PV ADD HOR SPLITTER

Home

4D View v14

PV ADD HOR SPLITTER


PV ADD HOR SPLITTER ( area ; splitter ; position ; locked )

Parameter	Type	Description
area	Longint	4D View area
splitter	Integer	Horizontal separator number
position	Integer	Position of separator with respect to last separator in pixels
locked	Integer	0 = Unlocked; 1 = Locked

Description

The PV ADD HOR SPLITTER command creates a new horizontal splitter in area, whose number is passed in splitter. The splitter is created at position pixels from the last splitter of the area or, if the area does not contain a splitter, from the upper border of the area (outside of toolbars).

If the locked parameter is equal to 1, the pane cannot be resized manually. If it is equal to 0, the pane can be resized freely by the user.

Notes:

The position of the pane includes the height of the column headers, which it is possible to recover using the PV Get area property command, by passing the pv column headers height constant as the second parameter.
The minimum height of a horizontal pane is 8 pixels.
You can see the number of horizontal panes in an area using the PV Get area property command by passing the pv hor pane count constant as the second parameter. In this case, PV Get area property returns 1 when there is not a horizontal splitter yet: the single pane is, in this case, the entire area.

Example

Add a horizontal pane, 30 pixels high, following panes that are already in the area.

 C_LONGINT($HorPaneNum) `Number of existing horizontal panes

 C_LONGINT($Position) `Position of pane

 

  `Number of horizontal panes

 $HorPaneNum:=PV Get area property(Area;pv hor pane count)

 $Position:=30 ` 30 pixels high

 PV ADD HOR SPLITTER(Area;$HorPaneNum;$Position;0) `Resizable

Error management

If the PV ADD HOR SPLITTER command is executed when the area is in"frozen pane" mode, the error 92 (No splitter can be added when panes are frozen) is generated.