4D Doc Center : PV FREEZE PANES

Home

4D View v14

PV FREEZE PANES


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

System variables and 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.