Command PV ADD HOR SPLITTER

PV ADD HOR SPLITTER

version 6.8

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

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.

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

PV ADD VERT SPLITTER, PV REMOVE HOR SPLITTER.

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.