Command PV ADD VERT SPLITTER

PV ADD VERT SPLITTER

version 6.8

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

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

The PV ADD VERT SPLITTER command creates a new vertical splitter in area, whose number is passed in splitter. The splitter is created at position pixels from the left border of area.

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 width of the row headers, which it is possible to recover using the PV Get area property command, by passing the pv row headers width constant as the second parameter.

• The minimum width of a vertical pane is 8 pixels.

• You can see the number of vertical panes in an area using the PV Get area property command by passing the pv vert pane count constant as the second parameter. In this case, PV Get area property returns 1 when there is not a vertical splitter yet: the single pane is, in this case, the entire area.

Take a spreadsheet containing twenty or so columns: the first contains a reference (for example, product code), which must absolutely remain visible, regardless of the cell being modified by the user. We will then create a vertical pane to display this column A.

   C_LONGINT($ColumnWidth)  `Width of column A (in pixels)
   $ColumnWidth:=PV Get column width(Area; 1)  `Column A
   PV ADD VERT SPLITTER(Area;1;$ColumnWidth;0)  `Resizable

PV ADD HOR SPLITTER, PV REMOVE VERT SPLITTER.

If the PV ADD VERT 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.