PV FREEZE PANES
version 11.2
PV FREEZE PANES (area; mode)
Parameter | Type | Description | |
area | Longint | 4D View area | |
mode | Longint | 0=lock scrolling, 1=lock scrolling and | |
modification of headers |
Description
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
See Also
System Variables or Sets
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.