4D v13

PV FREEZE PANES

Home

 
4D View v13
PV FREEZE PANES

PV FREEZE PANES 


 

PV FREEZE PANES ( area ; mode ) 
Parameter Type   Description
area  Longint in 4D View area
mode  Longint in 0=lock scrolling, 1=lock scrolling and modification of headers

The PV FREEZE PANES command freezes the first horizontal pane and/or the first vertical pane in the 4D View area. In order for the command to function, the area must contain at most one vertical splitter and/or one horizontal splitter and must not already be in "frozen" mode.

The mode parameter is used to specify the type of locking carried out in the area:

  • If mode = 0, only scrolling inside the pane is frozen. This locking is that carried out when using the Freeze Panes command of the View menu.
  • If mode = 1, the locking is extended: in addition to scrolling, the locking affects header modifications (style, font size, etc.) and clicking in a cell of the pane will select all of the column/row.

If the area does not contain a pane splitter or if it contains more than one vertical or horizontal pane splitter, the command does nothing and the OK variable is set to 0.
If the command is executed correctly, the OK variable is set to 1 and the View menu is modified accordingly: the Freeze Panes command is dimmed and the Unfreeze Panes command is activated.

To change the area back to "standard pane" mode, it is necessary to execute the PV UNFREEZE PANES command or for the user to select the Unfreeze Panes menu command.

Example  

The following code makes sure that the area contains two horizontal panes (one splitter = two panes) and freezes them in extended mode:

 $nbpanes:=PV Get area property(area;pv hor pane count)
 If($nbpanes=2)
    PV FREEZE PANES(area;1)
 End if

If the area does not contain any pane splitters or if it contains more than one vertical or horizontal pane splitter, the command does nothing and the OK variable is set to 0. If the command is executed correctly, the OK variable is set to 1.

 
PROPERTIES 

Product: 4D
Theme: PV Panes
Number: 15794

The OK variable is changed by the command

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D View v11.2

 
SEE ALSO 

PV UNFREEZE PANES