FREEZE - v14


freeze                        p=<panel> , b=<button>{,node=<i>}|
mb{,p=<pulldown> , b=<option> |
all

Function

Freeze use of a GUI object (panels, button, node, etc.)  making it unavailable for selection by the user.

Parameters

p=

Is the menu or panel number in a range from 1 to 96.

 

 

b=

The button number in the panel, as defined in the corresponding options file (*.tab). If it is not specified then all the buttons of the panel are frozen.

Note: not used if p represent a Tab Container

 

 

node=

The reference id of a Tree View node (button type 300)   which is to be frozen. Naturally if an item has sub-nodes, then freezing or unfreezing a node means that every element in the branch will be enabled or disabled.

 

 

mb {p=,b=}

Freezes the entire menu bar
or if used in conjunction with p= and b= a single option of the menu bar.

freeze mb, p=2 to freeze entirely the second pulldown of the menu bar

freeze mb, p=1, b=3 to freeze the third option of the first pulldown of the menu bar

 

 

all

freezes the menu bar, if present, and all the existing panels.

Examples

freeze p=the_panel,b=the_button
freeze mb

freeze mb,p=the_pulldown, b=the_option

freeze all

freeze p=1,b=2,node=20

Notes

In Eagle V12 and later  only one bitmap button which has been saved with an Alpha layer of transparency is required to represent all states of a button image, including frozen.  So, now for the different status instead of three files : TU<name> for the button-up, TD<name> for the button-down and TF<name> for the frozen button one will suffice.

 

Full details of use and configuration of the BAR menu can be found in the relevant sections of the UI Framework documentation and the Eagle Configuration section.

 

See also

panel, option, polling, unfreeze, Framework documentation