Command PV FREEZE PANES

4D View

PV FREEZE PANES

version 11.2


PV FREEZE PANES (area; mode)

ParameterTypeDescription
areaLongint4D View area
modeLongint0=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

PV UNFREEZE PANES.

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.