on

(default) Create the grid
 

off

Destroy a grid
 

add

Add row or column
 

delete

Delete row or column
 

set

Set the content of a cell
 

fetch

Get the content of a cell, row, column or multi-selection area. This field requires an Eagle variable to save the appropriately formatted resulting string.
 

select

Select a cell, a row, a column or the entire grid
 

id

Grid identifier
 

panel

(only with the on primer) Panel id in which the grid will be created
 

x

X co-ordinate of the button in the menu
 

y

Y co-ordinate of the button in the menu
 

w

Width of the button
 

h

Height of the button
 

style

(only with the on primer) Define the grid behavior:

· style= 1   (default) cell selection with header highlight on cursor tracking;

· style=2 cell selection with complete highlight on cursor tracking;

· style=3 row selection with header highlight on cursor tracking;

· style=4 row selection with complete highlight on cursor tracking;

· style=5 column selection with header highlight on cursor tracking;

· style=6 column selection with complete highlight on cursor tracking;
 

mode

1. Creating a grid (on primer) Enables the editing mode selection:

· mode = 1  (default) F2

· mode = 2  Double click with left button

· mode = 3 F2 + double click with left button

2. Adding a column (add for column) Enables creation of column as read only:

· mode = 0  (default) cells readable and writable

· mode = 1       read-only cell
 

sort

(only with the on primer) String that defines the sorting behavior:

· none        (default)  sorting disabled

· column    enable sort only for columns

· row           enable sort only for rows

· all              enable all sort types
 

align

(only with the add primer for column) Setting the content alignment in the columns cells:

· align=1   left

· align=2   center

· align=3  right

column

1-based value that indicates the column index (1 based) or determinates the position in which the column will be added or removed;

A special behavior is related to column = -1:

· adding a column, the new column will be appended to the end;

·  removing columns, each columns will be deleted;

row

1-based value that indicates the row index or determines the position in which a row will be added or removed;

A unique behavior is related to row = -1:

· adding a row, the new row will be appended to the end;

· removing rows, each row will be deleted;
 

size

(only with the add primer) The dimension of the new column (width) or a new row (height)
 

title

(only with the add primer) Contains the text to insert in the header of the row or column.  Note in the case of a row the title will be displayed if the header parameter is applied
 

header

(only with the add primer for row) When applied, indicates that the text inside the header is defined using the title parameters.
 

If the header is not included in the row definition, the header will display the index of the row, like Microsoft Excel
 

type

(only with the add primer for column) Define the type of the cells in new columns.  Developers can choose between various types:

• type=1 : edit field (default)

•  type=2 : check box

• type=3  : three-state check box

• type=4 : combo box

•  type=5 : image cell (bitmap file with transparent background)

text

(only with the set primer) String to be assigned a specific cell.  The content depends on the cell type:

•  type=1 :  string with text for edit field

•  type=2 : 1 for check and -1 for uncheck in checkbox

• type=3  : 1 for check, 0 for indeterminate and -1 for uncheck in three-state checkbox

•  type=4 :  not used; the combo box needs an options array

• type=5 : a string that contains the picture display mode (optional) and the bitmap path separated by a # character:

                                      image.bmp or type#image.bmp

                The display mode can assume the following value:

·         a : (default)picture adopts column alignment

·         t : picture is tiled

·         s : picture is stretched
 

options
 

readonly

(only with the set primer in a combo box cell) String array containing the combo box options

When adding a column (“add” for column) it enables the creation of a column as “read only”:
• (default)  column readable and writable
• readonly  read-only column