4D v13

PV ADD VERT SPLITTER

Home

 
4D View v13
PV ADD VERT SPLITTER

PV ADD VERT SPLITTER 


 

PV ADD VERT SPLITTER ( area ; splitter ; position ; locked ) 
Parameter Type   Description
area  Longint in 4D View area
splitter  Integer in Vertical separator number
position  Integer in Position of separator with respect to the last separator in pixels
locked  Integer in 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.

Example  

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

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.

 
PROPERTIES 

Product: 4D
Theme: PV Panes
Number: 15968

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D View 6.8

 
SEE ALSO 

PV ADD HOR SPLITTER
PV REMOVE VERT SPLITTER