GRIDPLUS2 - Reference
Home Reference Manpage Examples Download License Contact

GRIDPLUS Commands/Modes

Note: If you are new to GRIDPLUS read the grid reference first.

The main GRIDPLUS command has the following format:-

gridplus::gridplus mode ?option value(s) ...? ?layout?

The modes available are:-

addAdd non-Gridplus widget to Group.
buttonCreate Grid of buttons.
calendarCreate a calendar.
checkbuttonCreate Grid of checkbuttons.
clearClear specified window.
containerCreate a GRIDPLUS container.
dateCreate a Grid of dropdown date selectors.
defineDefine GRIDPLUS widgets (optional).
dropdownCreate a Grid of dropdowns (comboboxes).
entryCreate Grid of entries.
gotoGoto specified label in tagged text display.
gridCreate GRIDPLUS Grid.
layoutCreate GRIDPLUS Layout.
lineCreate line.
linkCreate Grid of links.
menuCreate menubar.
menubuttonCreate a Grid of menubuttons.
notebookCreate notebook.
optionsetCreate an option-set.
packPack layout for resizable windows.
paneCreate a paned window.
radiobuttonCreate Grid of radiobuttons.
setSet GRIDPLUS options.
spinboxCreate Grid of spinboxes.
tablelistCreate scrollable tablelist.
textCreate scrollable text.
treeCreate scrollable tree.
widgetCreate Grid of widgets.
windowCreate toplevel window and set window options.


The following GRIDPLUS commands are used to set/unset the values of GRIDPLUS items/widgets:-

gridplus::gpdelete item ?options?
gridplus::gpdelete item ?options? ?|? ?column? match|index|line|node

gridplus::gpinsert item position value

gridplus::gpmap itemlist valuelist
gridplus::gpmap itemlist elementlist array
gridplus::gpmap itemlist keylist dict

gridplus::gpselect item ?options? match|index|node|date ?column?
gridplus::gpselect item ?options? | ?column? match

gridplus::gpset ?options? item value
gridplus::gpset {item value ...}

gridplus::gpupdate item ?options? rowdata
gridplus::gpupdate item ?options? | column value
gridplus::gpupdate item ?options? | column match | rowdata
gridplus::gpupdate item ?options? | column match | column value

gridplus::gpunset {item ...}


The following GRIDPLUS commands are used to perform clipboard operations to text and entry widgets:-

gridplus::gpclear ?item?

gridplus::gpcopy ?item?

gridplus::gpcut ?item?

gridplus::gppaste ?item?


The following GRIDPLUS commands are used to perform find operations on text widgets.

gridplus::gpfind item string ?direction?

gridplus::gpfind_dialog ?item?


The following GRIDPLUS commands are used to perform SQL (TDBC) database queries and map/return the result.

gridplus::gpdb window query ?tablelist|prefix|dict|=?
gridplus::gpdb window query foreach body ?prefix?


The following GRIDPLUS command is used to navigate text and calendar widgets.

gridplus::gpnav item target ?increment?


The following GRIDPLUS command can be used to perform basic date calculations.

gridplus::gpdate ?action? ?date?


The following GRIDPLUS command can be used to simplify setting of Option Database options.

gridplus::gpoptions {option value ...}


GRIDPLUS Generated Widget/Command Names

Widget Names:

grid_name,widget_id

grid_nameName of grid.
widget_idWidget ID without leading dot.

Examples assuming an entry with ID ".firstname" in grid ".person":-

Main/Root Window:.person,firstname
Toplevel Window:.mywindow.person,firstname

Command/Callback Names:

grid,widget_id
...or...
toplevel:grid,widget_id

gridName of grid without leading dot.
toplevelName of toplevel window without leading dot.
widget_idWidget ID without leading dot.

Examples assuming a button with ID ".saveperson" in grid ".actions":-

Main/Root Window:actions,saveperson
Toplevel Window:mywindow:actions,saveperson

Tablelist, Text and Tree Names:

It maybe neccessary to reference Tablelist, Text or Tree widgets directly in order to get information about the widget -or- to set an attribute not available through GRIDPLUS.

GRIDPLUS uses a simple widget naming scheme which makes this easy.

Examples assuming a GRIDPLUS widget called ".mywidget" of each of the above types:-

Tablelist:.mywidget.tablelist
Text:.mywidget.text
Tree:.mywidget.tree

For example: To get the number of rows in a tablelist:-

.mywidget.tablelist size


Copyright © 2015 Adrian Davis.