grail.widgets.gsimplegrid module

Version: 16.2

Table of Contents

Warning

Currently lacks the Tkinter style of accessing/configuring components. Meaning the cget/configure methods do not function correctly on this widget.

Description

The GSimpleGrid widget is what is known as a Compound Widget. This widget provides you with the a very simple way of generating a NxM grid that corresponds to a 2-D list of RTV objects with the same NxM layout.

GSimpleGrid Widget

The GSimpleGrid widget inherits from,
class GSimpleGrid([parent, **keywords])

Provides a very simple grid layout based on a 2-D list of RTV objects.

Arguments:
parent : Tkinter.Frame
Parent widget, widget we insert into.
keywords
Variable keyword list defined below.
Keywords:
rtvs
A NxM 2-D list of RTV objects that indicates the layout of the simple grid's GTextEntry objects.
textentrywidth
Width of each of the text entries.
hlabels:
A list of strings to insert along the horizontal top of the grid. The length of the list of strings should be equivalent to N widgets in the NxM rtvs list.
Signal:
const.sigON_TEXT_ENTRY_CHANGE
Emitted when one of the text entries changes. This is generated with the new string from the changed entry as an argument.
Components:

None.

This widget is an old style widget that has not been updated to allow component access via the Tkinter cget and configure functions.

disable()
Set all the entries so they ignore the user events.
enable()
Set all the entries so they respond to user events.
findtextentries(str_)
Returns a list of text entries containing the same string.
getcolumncount()
Returns the number of columns in the grid.
getrowcount()
Returns the number of rows in the grid.
nmthtextentry(col, row)
Retrieves the entry widget located at (row,col) in the grid.
updatevars()
Synchronizes each of the rtvs with their respective entries.