OPTIONS - v14


options                      {on|off},p=<i>, f=<file>
,layout=<file>

Function

Used to describe populate and describe the layout for controls in a specified panel.  The definitions are taken from a file with the TAB extension.

Parameters

on

(default) inserts the controls into the panel.

 

 

off

Unload a panel without removing it from the screen.

 

 

p=

Specify the panel index to fill up. The value must be in the range 1 to 96

 

 

f=

Specifies the <filename>  with menu file (extension TAB).  The format of tab file is
opt,x,y,w,h,b,f,t, <text>:<commands>
 
 
and this together with additional options are explained below in Table 1 and Table 2.
 

  layout=

 Specify the <filename> which contains the dynamic layout content of a panel.  Anchoring configuration (extension TAB) is applicable only to Panels of  PIN= -17, -18, -19, -20, -21 or -22. See Anchoring and Autosizing Controls for details.  When the panel of this type is resized the panel layout is managed taking its reference from this file.

 

Table 1  - Format of Options File (f=<options_file>.TAB)

The format, very similar to the MEN file format in previous versions of  Eagle versions, is explained below:

 

Prototype :

 

 

 

opt,x,y,w,h,b,f,t, <text>:<commands>      

 

opt

option number. If 0 then the option is skipped.

x

x co-ordinate of the button in the menu grid.

y

 y co-ordinate of the button in the menu grid.

w

 the width of the button in grid units. Width depends on the pixel unit (u parameter) specified in the PANEL command

h

the height of the button in grid units

b

background colour for buttons/text

f

foreground colour for buttons/text

t

number to specify the  button control type such as  push, graphic,  label, edit, input, combo box, checkbox, radio box, scroll, frame, status, tree, OCX, colorpicker, hyperlink, rich edit and  tooltip.  The table of controls is listed in Table 2 below

<text>

this entry depends on the button type : typically text message, array, settings etc. Refer to individual controls for details

<commands>

the action to take when selected.

 

Table 2  - Button Types  (t=<i>)

The available button types possible to use in the OPTIONS TAB file are listed below; Note that the GRIDVIEW and LISTVIEW  are technically not OPTIONS buttons but separate commands and are included here for reference only.  
 

Type

Index

Status to previous version

Push Button

1

Sameas Eagle v.12

Button with Bitmap

4

Extended

Label

5

Same as Eagle v.12

Edit

6

Extended

Combo Box with List

27

Same in Eagle v.12

Combo Box Multi Column List

37

New

Combo Box with Grid

47,57,67

New

Check Box

8

Same as Eagle v.12

Three State Check Box

18

New

Rich Edit

16

New

Radio Group Box

29,39

Extended

Slider with arrow marker

10,110

Changed

Slider with indicator

210,310

New

Scroll Bar

410,510

New

Zoom Bar

610,710

New

Spin Button

11,111

New

Spin Edit Button

211,311

New

Frame Color

12

Extended

Frame Title

120

Extended

Static Label

220

Same as  Eagle v.12

Tree View

300

Extended

Color Picker Button

500

New

Hyperlink

501

New

Progress Bar

502

New

Grid View

none (GRIDVIEW)

New

List Button

505,506

New

List View

none (LIST)

Extended

Special Types

 

 

Button Font

888

Same as Eagle v.12

Tooltip

999

Same as Eagle v.12

 

Examples

Please refer to comprehensive GUI Guide for   details of PANELS and OPTIONS

See also

panel, polling, panel options, tabbed panels, ldir, GUI Guide