Class dGrid

Specifies whether the cell editor, if any, is activated upon cell selection.

When True, alternate rows of the grid are colored according to
the RowColorOdd and RowColorEven properties  (bool)

Read-only object reference to the Dabo Application object.  (dApp).

When True, changing the VerticalHeaders property will adjust the HeaderHeight
to accommodate the rotated labels. Default=False.  (bool)

Specifies the background color of the object. (str, 3-tuple, or wx.Colour)

The base Dabo class of the object. Read-only.  (class)

Base key used when saving/restoring preferences  (str)

Specifies the color of the border drawn around the control, if any.

Default='black'  (str, 3-tuple, or wx.Colour)

Style of line for the border drawn around the control.

Possible choices are:
	"Solid"  (default)
	"Dash"
	"Dot"
	"DotDash"
	"DashDot"

Specifies the type of border for this window. (str).

Possible choices are:
	"None"
	"Simple"
	"Sunken"
	"Raised"
			

Width of the border drawn around the control, if any. (int)

Default=0 (no border)
			

The position of the bottom side of the object. This is a
convenience property, and is equivalent to setting the Top property
to this value minus the Height of the control.  (int)

The caption of the object. (str)

Specifies the width of the cell highlight box.

List of dColumns, same as self.Columns.  (list)

The class the object is based on. Read-only.  (class)

Class to instantiate when a change to ColumnCount requires
additional columns to be created. Default=dColumn.  (dColumn subclass)

Number of columns in the grid.  (int)

List of dColumns.  (list)

Reference to the sizer that controls this control's layout.  (dSizer)

Reference to the sizer item that control's this control's layout.

This is useful for getting information about how the item is being
sized, and for changing those settings.  (SizerItem)
			

Value of the currently selected grid cell  (varies)

Currently selected column index. (int)

Field for the currently selected column  (str)

Currently selected row  (int)

The set of data displayed in the grid.  (set of dicts)

When DataSource isn't defined, setting DataSet to a set of dicts,
such as what you get from calling dBizobj.getDataSet(), will
define the source of the data that the grid displays.

If DataSource is defined, DataSet is read-only and returns the dataSet
from the bizobj.

The source of the data to display in the grid.  (str)

This corresponds to a bizobj with a matching DataSource on the form,
and setting this makes it impossible to set DataSet.

Reference to the object that will handle files dropped on this control.
When files are dropped, a list of them will be passed to this object's
'processDroppedFiles()' method. Default=None  (object or None)

Reference to the object that will handle text dropped on this control.
When text is dropped, that text will be passed to this object's
'processDroppedText()' method. Default=None  (object or None)

Dynamically determine the value of the ActivateEditorOnSelect property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ActivateEditorOnSelect property. If DynamicActivateEditorOnSelect is set to None (the default), ActivateEditorOnSelect
will not be dynamically evaluated.

Dynamically determine the value of the AlternateRowColoring property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
AlternateRowColoring property. If DynamicAlternateRowColoring is set to None (the default), AlternateRowColoring
will not be dynamically evaluated.

Dynamically determine the value of the BackColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
BackColor property. If DynamicBackColor is set to None (the default), BackColor
will not be dynamically evaluated.

Dynamically determine the value of the BorderColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
BorderColor property. If DynamicBorderColor is set to None (the default), BorderColor
will not be dynamically evaluated.

Dynamically determine the value of the BorderLineStyle property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
BorderLineStyle property. If DynamicBorderLineStyle is set to None (the default), BorderLineStyle
will not be dynamically evaluated.

Dynamically determine the value of the BorderStyle property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
BorderStyle property. If DynamicBorderStyle is set to None (the default), BorderStyle
will not be dynamically evaluated.

Dynamically determine the value of the BorderWidth property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
BorderWidth property. If DynamicBorderWidth is set to None (the default), BorderWidth
will not be dynamically evaluated.

Dynamically determine the value of the Caption property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Caption property. If DynamicCaption is set to None (the default), Caption
will not be dynamically evaluated.

Dynamically determine the value of the CellHighlightWidth property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
CellHighlightWidth property. If DynamicCellHighlightWidth is set to None (the default), CellHighlightWidth
will not be dynamically evaluated.

Dynamically determine the value of the ColumnClass property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ColumnClass property. If DynamicColumnClass is set to None (the default), ColumnClass
will not be dynamically evaluated.

Dynamically determine the value of the ColumnCount property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ColumnCount property. If DynamicColumnCount is set to None (the default), ColumnCount
will not be dynamically evaluated.

Dynamically determine the value of the CurrentColumn property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
CurrentColumn property. If DynamicCurrentColumn is set to None (the default), CurrentColumn
will not be dynamically evaluated.

Dynamically determine the value of the CurrentField property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
CurrentField property. If DynamicCurrentField is set to None (the default), CurrentField
will not be dynamically evaluated.

Dynamically determine the value of the CurrentRow property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
CurrentRow property. If DynamicCurrentRow is set to None (the default), CurrentRow
will not be dynamically evaluated.

Dynamically determine the value of the DataSet property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
DataSet property. If DynamicDataSet is set to None (the default), DataSet
will not be dynamically evaluated.

Dynamically determine the value of the DataSource property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
DataSource property. If DynamicDataSource is set to None (the default), DataSource
will not be dynamically evaluated.

Dynamically determine the value of the Editable property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Editable property. If DynamicEditable is set to None (the default), Editable
will not be dynamically evaluated.

Dynamically determine the value of the Enabled property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Enabled property. If DynamicEnabled is set to None (the default), Enabled
will not be dynamically evaluated.

Dynamically determine the value of the Font property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Font property. If DynamicFont is set to None (the default), Font
will not be dynamically evaluated.

Dynamically determine the value of the FontBold property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
FontBold property. If DynamicFontBold is set to None (the default), FontBold
will not be dynamically evaluated.

Dynamically determine the value of the FontFace property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
FontFace property. If DynamicFontFace is set to None (the default), FontFace
will not be dynamically evaluated.

Dynamically determine the value of the FontItalic property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
FontItalic property. If DynamicFontItalic is set to None (the default), FontItalic
will not be dynamically evaluated.

Dynamically determine the value of the FontSize property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
FontSize property. If DynamicFontSize is set to None (the default), FontSize
will not be dynamically evaluated.

Dynamically determine the value of the FontUnderline property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
FontUnderline property. If DynamicFontUnderline is set to None (the default), FontUnderline
will not be dynamically evaluated.

Dynamically determine the value of the ForeColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ForeColor property. If DynamicForeColor is set to None (the default), ForeColor
will not be dynamically evaluated.

Dynamically determine the value of the HeaderBackColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HeaderBackColor property. If DynamicHeaderBackColor is set to None (the default), HeaderBackColor
will not be dynamically evaluated.

Dynamically determine the value of the HeaderForeColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HeaderForeColor property. If DynamicHeaderForeColor is set to None (the default), HeaderForeColor
will not be dynamically evaluated.

Dynamically determine the value of the HeaderHeight property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HeaderHeight property. If DynamicHeaderHeight is set to None (the default), HeaderHeight
will not be dynamically evaluated.

Dynamically determine the value of the HeaderHorizontalAlignment property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HeaderHorizontalAlignment property. If DynamicHeaderHorizontalAlignment is set to None (the default), HeaderHorizontalAlignment
will not be dynamically evaluated.

Dynamically determine the value of the HeaderVerticalAlignment property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HeaderVerticalAlignment property. If DynamicHeaderVerticalAlignment is set to None (the default), HeaderVerticalAlignment
will not be dynamically evaluated.

Dynamically determine the value of the Height property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Height property. If DynamicHeight is set to None (the default), Height
will not be dynamically evaluated.

Dynamically determine the value of the HorizontalScrolling property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
HorizontalScrolling property. If DynamicHorizontalScrolling is set to None (the default), HorizontalScrolling
will not be dynamically evaluated.

Dynamically determine the value of the Left property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Left property. If DynamicLeft is set to None (the default), Left
will not be dynamically evaluated.

Dynamically determine the value of the MousePointer property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
MousePointer property. If DynamicMousePointer is set to None (the default), MousePointer
will not be dynamically evaluated.

Dynamically determine the value of the Position property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Position property. If DynamicPosition is set to None (the default), Position
will not be dynamically evaluated.

Dynamically determine the value of the RowColorEven property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
RowColorEven property. If DynamicRowColorEven is set to None (the default), RowColorEven
will not be dynamically evaluated.

Dynamically determine the value of the RowColorOdd property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
RowColorOdd property. If DynamicRowColorOdd is set to None (the default), RowColorOdd
will not be dynamically evaluated.

Dynamically determine the value of the RowHeight property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
RowHeight property. If DynamicRowHeight is set to None (the default), RowHeight
will not be dynamically evaluated.

Dynamically determine the value of the RowLabelWidth property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
RowLabelWidth property. If DynamicRowLabelWidth is set to None (the default), RowLabelWidth
will not be dynamically evaluated.

Dynamically determine the value of the RowLabels property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
RowLabels property. If DynamicRowLabels is set to None (the default), RowLabels
will not be dynamically evaluated.

Dynamically determine the value of the SameSizeRows property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
SameSizeRows property. If DynamicSameSizeRows is set to None (the default), SameSizeRows
will not be dynamically evaluated.

Dynamically determine the value of the SearchDelay property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
SearchDelay property. If DynamicSearchDelay is set to None (the default), SearchDelay
will not be dynamically evaluated.

Dynamically determine the value of the Searchable property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Searchable property. If DynamicSearchable is set to None (the default), Searchable
will not be dynamically evaluated.

Dynamically determine the value of the SelectionBackColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
SelectionBackColor property. If DynamicSelectionBackColor is set to None (the default), SelectionBackColor
will not be dynamically evaluated.

Dynamically determine the value of the SelectionForeColor property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
SelectionForeColor property. If DynamicSelectionForeColor is set to None (the default), SelectionForeColor
will not be dynamically evaluated.

Dynamically determine the value of the SelectionMode property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
SelectionMode property. If DynamicSelectionMode is set to None (the default), SelectionMode
will not be dynamically evaluated.

Dynamically determine the value of the ShowCellBorders property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ShowCellBorders property. If DynamicShowCellBorders is set to None (the default), ShowCellBorders
will not be dynamically evaluated.

Dynamically determine the value of the ShowColumnLabels property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ShowColumnLabels property. If DynamicShowColumnLabels is set to None (the default), ShowColumnLabels
will not be dynamically evaluated.

Dynamically determine the value of the ShowHeaders property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ShowHeaders property. If DynamicShowHeaders is set to None (the default), ShowHeaders
will not be dynamically evaluated.

Dynamically determine the value of the ShowRowLabels property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ShowRowLabels property. If DynamicShowRowLabels is set to None (the default), ShowRowLabels
will not be dynamically evaluated.

Dynamically determine the value of the Size property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Size property. If DynamicSize is set to None (the default), Size
will not be dynamically evaluated.

Dynamically determine the value of the Sortable property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Sortable property. If DynamicSortable is set to None (the default), Sortable
will not be dynamically evaluated.

Dynamically determine the value of the StatusText property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
StatusText property. If DynamicStatusText is set to None (the default), StatusText
will not be dynamically evaluated.

Dynamically determine the value of the TabNavigates property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
TabNavigates property. If DynamicTabNavigates is set to None (the default), TabNavigates
will not be dynamically evaluated.

Dynamically determine the value of the Tag property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Tag property. If DynamicTag is set to None (the default), Tag
will not be dynamically evaluated.

Dynamically determine the value of the ToolTipText property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
ToolTipText property. If DynamicToolTipText is set to None (the default), ToolTipText
will not be dynamically evaluated.

Dynamically determine the value of the Top property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Top property. If DynamicTop is set to None (the default), Top
will not be dynamically evaluated.

Dynamically determine the value of the Transparency property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Transparency property. If DynamicTransparency is set to None (the default), Transparency
will not be dynamically evaluated.

Dynamically determine the value of the VerticalHeaders property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
VerticalHeaders property. If DynamicVerticalHeaders is set to None (the default), VerticalHeaders
will not be dynamically evaluated.

Dynamically determine the value of the VerticalScrolling property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
VerticalScrolling property. If DynamicVerticalScrolling is set to None (the default), VerticalScrolling
will not be dynamically evaluated.

Dynamically determine the value of the Visible property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Visible property. If DynamicVisible is set to None (the default), Visible
will not be dynamically evaluated.

Dynamically determine the value of the Width property.

Specify a function and optional arguments that will get called from the
update() method. The return value of the function will get set to the
Width property. If DynamicWidth is set to None (the default), Width
will not be dynamically evaluated.

This setting enables/disables cell editing globally.  (bool)

When False, no cells will be editable by the user. When True, cells in
columns set as Editable	will be editable by the user. Note that grids
and columns are both set with Editable=False by default, so to enable
cell editing you need to turn	it on in the appropriate column as well
as in the grid.

Specifies whether the object and children can get user input. (bool)

Name of encoding to use for unicode  (str)

Specifies font object for this control. (dFont)

Specifies if the font is bold-faced. (bool)

Human-readable description of the current font settings. (str)

Specifies the font face. (str)

Specifies the platform-native font info string. Read-only. (str)

Specifies whether font is italicized. (bool)

Specifies the point size of the font. (int)

Specifies whether text is underlined. (bool)

Specifies the foreground color of the object. (str, 3-tuple, or wx.Colour)

Object reference to the dForm containing the object. Read-only. (dForm).

Optional color for the background of the column headers.  (str or None)

This is only the default: setting the corresponding dColumn property will
override.

Optional color for the foreground (text) of the column headers.  (str or None)

This is only the default: setting the corresponding dColumn property will
override.

Height of the column headers.  (int)

The horizontal alignment of the header captions. ('Left', 'Center', 'Right')

This is only the default: setting the corresponding dColumn property will
override.

The vertical alignment of the header captions. ('Top', 'Center', 'Bottom')

This is only the default: setting the corresponding dColumn property will
override.

Specifies the height of the object. (int)

Specifies the context-sensitive help text associated with this
window. (str)
			

Is scrolling enabled in the horizontal direction?  (bool)

When True, Mouse Enter events fire the onHover method, and
MouseLeave events fire the endHover method  (bool)

Specifies the left position of the object. (int)

Specifies which events to log.  (list of strings)

If the first element is 'All', all events except the following listed events
will be logged.
Event logging is resource-intensive, so in addition to setting this LogEvents
property, you also need to make the following call:

	>>> dabo.eventLogging = True

Maximum allowable height for the control in pixels.  (int)

Maximum allowable size for the control in pixels.  (2-tuple of int)

Maximum allowable width for the control in pixels.  (int)

Minimum allowable height for the control in pixels.  (int)

Minimum allowable size for the control in pixels.  (2-tuple of int)

Minimum allowable width for the control in pixels.  (int)

Specifies the shape of the mouse pointer when it enters this window. (obj)

When False, the user cannot re-order the columns by dragging the headers  (bool)

When True (default), more than one cell/row/col can be selected at once  (bool)

Specifies the name of the object, which must be unique among siblings.

If the specified name isn't unique, an exception will be raised. See also
NameBase, which let's you set a base name and Dabo will automatically append
integers to make it unique.

Specifies the base name of the object.

The base name specified will become the object's Name, unless another sibling
already has that name, in which case Dabo will find the next unique name by
adding integers to the end of the base name. For example, if your code says:

	self.NameBase = "txtAddress"

and there is already a sibling object with that name, your object will end up
with Name = "txtAddress1".

This property is write-only at runtime.

Text to display for null (None) values.  (str)

The containing object. (obj)

The (x,y) position of the object. (tuple)

Reference to the Preference Management object  (dPref)

A unique identifier used for referencing by other objects. (str)

When False, the user cannot resize the columns  (bool)

When False, the user cannot resize the rows  (bool)

The position of the right side of the object. This is a
convenience property, and is equivalent to setting the Left property
to this value minus the Width of the control.  (int)

When alternate row coloring is active, controls the color
of the even rows  (str or tuple)

When alternate row coloring is active, controls the color
of the odd rows  (str or tuple)

Number of rows in the grid.  (int)

Row Height for all rows of the grid  (int)

Width of the label on the left side of the rows. This only changes
the grid if ShowRowLabels is True.  (int)

List of the row labels.  (list)

Is every row the same height?  (bool)

Specifies the delay before incrementeal searching begins.  (int or None)

As the user types, the search string is modified. If the time between
keystrokes exceeds SearchDelay (milliseconds), the search will run and
the search string	will be cleared.

If SearchDelay is set to None (the default), Application.SearchDelay will
be used.

Specifies whether the columns can be searched.   (bool)

If True, columns that have their Searchable properties set to True
will be searchable.

Default: True

Returns either a list of row/column numbers if SelectionMode is set to
either 'Row' or 'Column'. If SelectionMode is 'Cell', returns a list of 2-tuples,
where each 2-tuple represents a selected range of cells: the top-left and
bottom-right coordinates for a given range. If only a single cell is selected,
there will be only one 2-tuple in the list, with both values being the same.
If a continuous block of cells is selected, there will be only one 2-tuple in the
list, but the values will differ. If more than one discontinuous range is selected,
there will be as many 2-tuples as there are range blocks.  (list)

BackColor of selected cells  (str or RGB tuple)

ForeColor of selected cells  (str or RGB tuple)

Determines how the grid displays selections.  (str)
Options are:
	Cells/Plain/None - no row/col highlighting	(default)
	Row - the row of the selected cell is highlighted
	Column - the column of the selected cell is highlighted

The highlight color is determined by the SelectionBackColor and
SelectionForeColor properties.

Are borders around cells shown?  (bool)

Are column labels shown?  (bool)

DEPRECATED: Use ShowHeaders instead.

Are grid column headers shown?  (bool)

Are row labels shown?  (bool)

The size of the object. (tuple)

The sizer for the object.

Color of the icon is that identifies a column as being sorted.
Default="yellow".  (str or color tuple)

Determines how large the icon is that identifies a column as
being sorted. Default=8.  (int)

Specifies whether the columns can be sorted. If True,
and if the column's Sortable property is True, the column
will be sortable. Default: True  (bool)

Specifies the text that displays in the form's status bar, if any.

The text will appear when the control gets the focus, or when the
mouse hovers over the control, and will clear when the control loses
the focus, or when the mouse is no longer hovering.

For forms, set StatusText whenever you want to display a message.

Specifies whether Tab navigates to the next control (True, the default),
or if Tab moves to the next column in the grid (False).

Specifies whether this control can receive focus from keyboard navigation.

A property that user code can safely use for specific purposes.

Specifies the tooltip text associated with this window. (str)

The top position of the object. (int)

Transparency level of the control; ranges from 0 (transparent) to 255 (opaque).
Default=0. Does not currently work on Gtk/Linux.  (int)

Time in seconds to change transparency. Set it to zero to see instant changes.
Default=0.25 (float)

When True, the column headers' Captions are written vertically.
Default=False.  (bool)

Is scrolling enabled in the vertical direction?  (bool)

Specifies whether the object is visible at runtime.  (bool)

Specifies whether the object is physically visible at runtime.  (bool)

The Visible property could return True even if the object isn't actually
shown on screen, due to a parent object or sizer being invisible.

The VisibleOnScreen property will return True only if the object and all
parents are visible.

The width of the object. (int)

The platform-specific handle for the window. Read-only. (long)

Occurs when a window background has been erased and needs repainting.

Occurs after the control or form is created.

Occurs when the control or form is destroyed.

Occurs when the properties of a dFont have changed.

Occurs when the control gets the focus.

Occurs after the grid is sorted

Occurs before the grid is sorted

Occurs when the editor for a grid cell is shown, allowing the user to edit.

Occurs when the editor for a grid cell is hidden.

Occurs when the user edits the content of a grid cell.

Occurs when the user changes the value in the grid cell editor.

For a checkbox, this occurs when the user toggles the checkmark.
This event is not implemented for other grid cell editors, yet.

Occurs when the a new cell is selected in the grid.

Occurs when the grid's columns are resized.

Occurs when the context menu is requested in the grid region.

Occurs when the context menu is requested in the grid header region.

Occurs when an idle cycle happens in the grid header.

Occurs when the mouse pointer enters the grid's header region.

Occurs when the mouse pointer leaves the grid's header region.

Occurs when the left mouse button is clicked in the header region.

Occurs when the left mouse button is double-clicked in the header region.

Occurs when the left mouse button goes down in the header region.

Occurs when the left mouse button goes up in the header region.

Occurs when the mouse moves in the grid header region.

Occurs when the right mouse button is clicked in the header region.

Occurs when the left mouse button goes down in the header region.

Occurs when the left mouse button goes up in the header region.

Occurs when it's time to paint the grid header.

Occurs when the left mouse button is clicked in the grid region.

Occurs when the left mouse button is double-clicked in the grid region.

Occurs when the left mouse button goes down in the grid region.

Occurs when the left mouse button goes up in the grid region.

Occurs when the mouse moves in the grid region (not the headers).

Occurs when the right mouse button is clicked in the header region.

Occurs when the right mouse button goes down in the grid region.

Occurs when the right mouse button goes up in the grid region.

Occurs when the a new cell is selected in the grid.

Occurs when the grid's rows are resized.

Occurs when the event loop has no active events to process.

This is a good place to put redraw or other such UI-intensive code, so that it
will only run when the application is otherwise not busy doing other (more
important) things.

Occurs when a key is depressed and released on the
focused control or form.

Occurs when any key is depressed on the focused control or form.

Occurs when any key is released on the focused control or form.

Occurs when the user manually resizes a column of dListControl.

Occurs when the left mouse button is clicked in the header region of dListControl.

Occurs when the right mouse button is clicked in the header region of dListControl.

Occurs when the control loses the focus.

Occurs when a menu has just been closed.

Occurs when a menu is about to be opened.

Occurs when the mouse pointer enters the form or control.

Occurs when the mouse pointer leaves the form or control.

Occurs when the mouse's left button is depressed
and released on the control.

Occurs when the mouse's left button is double-clicked on the control.

Occurs when the mouse's left button is depressed on the control.

Occurs when the mouse's left button is released on the control.

Occurs when the mouse mouse's middle button is depressed
and released on the control.

Occurs when the mouse's middle button is double-clicked
on the control.

Occurs when the mouse's middle button is depressed on the control.

Occurs when the mouse's middle button is released on the control.

Occurs when the mouse moves in the control.

Occurs when the mouse mouse's right button is depressed
and released on the control.

Occurs when the mouse's right button is double-clicked on the control.

Occurs when the mouse's right button is depressed on the control.

Occurs when the mouse's right button is released on the control.

Occurs when the user scrolls the mouse wheel.

Occurs when the control's position changes.

Occurs when it is time to paint the control.

Occurs when the control or form is resized.

Occurs when a scrollable window reaches the bottom or right.

Occurs when a scrollable window is scrolled a line down or right.

Occurs when a scrollable window is scrolled a line up or left.

Occurs when a scrollable window is scrolled down or right by a full page.

Occurs when a scrollable window is scrolled up or left by a full page.

Occurs when the 'thumb' control of a scrollable window's scrollbars is moved.

Occurs when the 'thumb' control of a scrollable window's scrollbars is released.

Occurs when a scrollable window reaches the top or left.

Occurs when a drag operation begins in a tree.

Occurs when a drag operation ends in a tree.

Occurs when a container wants its controls to update
their properties.

Translates a position value for a control to absolute screen position.

Adds a column to the grid.

If no col (class or instance) is passed, a blank dColumn is added, which
can be customized	later. Any extra keyword arguments are passed to the
constructor of the new dColumn.

Instantiate object as a child of self.

The classRef argument must be a Dabo UI class definition. (it must inherit
dPemMixin). Alternatively, it can be a saved class definition in XML format,
as created by the Class Designer.

The name argument, if passed, will be sent along to the object's
constructor, which will attempt to set its Name accordingly. If the name
argument is not passed (or None), the object will get a default Name as
defined in the object's class definition.

Additional positional and/or keyword arguments will be sent along to the
object's constructor.

Add a character to the current incremental search.

Called by KeyDown when the user pressed an alphanumeric key. Add the
key to the current search and start the timer.

Called after a cell has been edited by the user.

Subclass hook. Called after the object's __init__ has run fully.
Subclasses should place their __init__ code here in this hook, instead of
overriding __init__ directly, to avoid conflicting with base Dabo behavior.

Automatically bind any on*() methods to the associated event.

User code only needs to define the callback, and Dabo will automatically
set up the event binding. This will satisfy lots of common cases where
you want an object or its parent to respond to the object's events.

To use this feature, just define a method on<EventName>(), or	if you
want a parent container to respond to the event, make a method in the
parent on<EventName>_<object Name or RegID>().

For example::
	
	class MyButton(dabo.ui.dButton):
		def onHit(self, evt):
			print "Hit!"

	class MyPanel(dabo.ui.dPanel):
		def afterInit(self):
			self.addObject(MyButton, RegID="btn1")

		def onHit_btn1(self, evt):
			print "panel: button hit!"

When the button is pressed, you'll see both 'hit' messages because of
auto event binding.

If you want to bind your events explicitly, you can turn off auto event
binding by calling::

	 dabo.autoBindEvents = False

This feature is inspired by PythonCard.

Set the column to the minimum width necessary to display its data.

Set colNum='all' to auto-size all columns. Set persist=True to persist the
new width to the user settings table.

Subclass hook. Called before the object is fully instantiated.
Usually, user code should override afterInit() instead, but there may be
cases where you need to set an attribute before the init stage is fully
underway.

Bind a dEvent to a callback function.

Bind a sequence of [dEvent, callback] lists.

Bind a key combination such as "ctrl+c" to a callback function.

See dKeys.keyStrings for the valid string key codes.
See dKeys.modifierStrings for the valid modifier codes.

Examples::

	# When user presses <esc>, close the form:
	form.bindKey("esc", form.Close)

	# When user presses <ctrl><alt><w>, close the form:
	form.bindKey("ctrl+alt+w", form.Close)

Makes this object topmost

Add columns with properties set based on the passed dataset.

A dataset is defined as one of:

	+ a sequence of dicts, containing fieldname/fieldvalue pairs.
	+ a string, which maps to a bizobj on the form.

The columns will be taken from the first record of the dataset,	with each
column header caption being set to the field name, unless	the optional
keyCaption parameter is passed. This parameter is a 1:1 dict containing
the data set keys as its keys, and the desired caption as the
corresponding value.

If the includeFields parameter is a sequence, the only columns added will
be the fieldnames included in the includeFields sequence. If the
includeFields	parameter is None, all fields will be added to the grid.

The columns will be in the order returned by ds.keys(), unless the
optional colOrder parameter is passed. Like the keyCaption property,
this is a 1:1 dict containing key:order.

Clears the background of custom-drawn objects.

Create another object just like the passed object. It assumes that the
calling object will be the container of the newly created object.

Given a position relative to this control, return a position relative
to the specified container. If no position is passed, returns the position
of this control relative to the container.

Called by uiApp when the user requests a cut operation.

Return None (the default) and uiApp will try a default cut operation.
Return anything other than None and uiApp will assume that the cut
operation has been handled.

Draws an arc (pie slice) of a circle centered around the specified point,
starting from 'startAngle' degrees, and sweeping counter-clockwise
until 'endAngle' is reached.

See the 'drawCircle()' method above for more details.

Draws a bitmap on the object at the specified position.

Draws a circle of the specified radius around the specified point.

You can set the color and thickness of the line, as well as the
color and hatching style of the fill. Normally, when persist=True,
the circle will be re-drawn on paint events, but if you pass False,
it will be drawn once only.

A drawing object is returned, or None if persist=False. You can
'remove' the drawing by setting the Visible property of the
returned object to False. You can also manipulate the position, size,
color, and fill by changing the various properties of the object.

Draws an ellipse contained within the rectangular space defined by
the position and size coordinates

See the 'drawCircle()' method above for more details.

Draws an arc (pie slice) of a ellipse contained by the specified
dimensions, starting from 'startAngle' degrees, and sweeping
counter-clockwise until 'endAngle' is reached.

See the 'drawCircle()' method above for more details.

Draws a horizontal or vertical gradient on the control. Default
is to cover the entire control, although you can specify positions.
The gradient is drawn with 'color1' as the top/left color, and 'color2'
as the bottom/right color.

Draws a line between (x1,y1) and (x2, y2).

See the 'drawCircle()' method above for more details.

Draws a series of connected line segments defined by the specified points.

The 'points' parameter should be a tuple of (x,y) pairs defining the shape. Lines
are drawn connecting the points sequentially, but a segment from the last
point to the first is not drawn, leaving an 'open' polygon. As a result, there is no
FillColor or HatchStyle defined for this.

See the 'drawCircle()' method above for more details.

Draws a polygon defined by the specified points.

The 'points' parameter should be a tuple of (x,y) pairs defining the
polygon.

See the 'drawCircle()' method above for more details.

Draws a rectangle of the specified size beginning at the specified
point.

See the 'drawCircle()' method above for more details.

Draws a rounded rectangle of the specified size beginning at the specified
point, with the specified corner radius.

See the 'drawCircle()' method above for more details.

Draws text on the object at the specified position
using the specified characteristics. Any characteristics
not specified will be set to the system default.

User hook called just before showing the context menu.

User code can append menu items, or replace/remove the menu entirely.
Return a dMenu or None from this hook. Default: no context menu.

Refresh the grid to match the data in the data set.

User hook called just before showing the context menu for the header.

User code can append menu items, or replace/remove the menu entirely.
Return a dMenu or None from this hook. The default menu includes an
option to autosize the column.

Called from the 'Find' dialog.

Sizes the HeaderHeight to comfortably fit the captions. Primarily used for
vertical captions or multi-line captions.

Resize the control to fit the size required by its sizer.

Zoom in on the font, by setting a higher point size.

Reset the font zoom back to zero.

Zoom out on the font, by setting a lower point size.

Given a position relative to this control, return a position relative
to the containing form. If no position is passed, returns the position
of this control relative to the form.

Return the fully qualified name of the object.

Return a bitmap snapshot of self as it appears in the UI at this moment.

Given a DataField value, return the corresponding column.

Given the x-coordinate, return the column object.

Given the x-coordinate, return the column index in self.Columns.

Returns an object that locks the current display when created, and
unlocks it when destroyed. This is generally safer than calling lockDisplay()
and unlockDisplay(), especially when used with callAfterInterval(), when
the unlockDisplay() calls may not all happen.

Returns the current mouse position on the entire screen
relative to this object.

Convenience method to let you call this directly on the object.

Returns a dictionary of property name/value pairs.

If a sequence of properties is passed, just those property values
will be returned. Otherwise, all property values will be returned.
The sequence of properties can be a list, tuple, or plain string
positional arguments. For instance, all of the following are
equivilent::

	print self.getProperties("Caption", "FontInfo", "Form")
	print self.getProperties(["Caption", "FontInfo", "Form"])
	t = ("Caption", "FontInfo", "Form")
	print self.getProperties(t)
	print self.getProperties(\*t)

An exception will be raised if any passed property names don't
exist, aren't actual properties, or are not readable (do not have
getter functions).

However, if an exception is raised from the property getter function,
the exception will get caught and used as the property value in the
returned property dictionary. This allows the property list to be
returned even if some properties can't be evaluated correctly by the
object yet.

Given the y-coordinate, return the row number.

Gets the current setting for the given property from the object's
ControllingSizer. Returns None if object is not in a sizer.

Returns a dict containing the object's sizer property info. The
keys are the property names, and the values are the current
values for those props.

Returns the value of the specified row and column.

If no row/col is specified, the current row/col will be used.

Make the object invisible.

Hook for subclasses. User code should do custom event binding
here, such as::
	
	self.bindEvent(dEvents.GotFocus, self.customGotFocusHandler)
	

Initialize behavior for the grid header region.

Hook for subclasses. User subclasses should set properties
here, such as::
	
	self.Name = "MyTextBox"
	self.BackColor = (192,192,192)
	

Returns True if the containership hierarchy for this control
includes the passed object reference.

Call the given function on this object and all of its Children. If
any object does not have the given function, no error is raised; it
is simply ignored.

Locks the visual updates to the control.

This can significantly improve performance when many items are being
updated at once.

IMPORTANT: you must call unlockDisplay() when you are done, or your
object will never draw. unlockDisplay() must be called once for every
time lockDisplay() is called in order to resume repainting of the
control. Alternatively, you can call lockDisplay() many times, and
then call unlockDisplayAll() once when you are done.

Note that lockDisplay currently doesn't do anything on GTK.

Returns the highest value of Order for all columns.

Move the column to a new position.

Moves this object's tab order after the passed obj.

Moves this object's tab order before the passed obj.

Given a position relative to the form, return a position relative
to this object. If no position is passed, returns the position
of this control relative to the form.

Occurs when the incremental search timer reaches its interval.
It is time to run the search, if there is any search in the buffer.

Called by uiApp when the user requests a paste operation.

Return None (the default) and uiApp will try a default paste operation.
Return anything other than None and uiApp will assume that the paste
operation has been handled.

Handler for files dropped on the control. Override in your
subclass/instance for your needs .

Handler for text dropped on the control. Override in your
subclass/instance for your needs .

Sort the grid column.

Toggle between ascending and descending. If the grid column index isn't
passed, the currently active grid column will be sorted.

Raise the passed Dabo event.

Abstract method: subclasses MUST override for UI-specifics.

Recreate the object.

Warning: this is experimental and is known to cause hair loss.

Called when the object is (re)drawn.

This is a user subclass hook, where you should put any drawing routines
to affect the object appearance.

Repaint the grid.

Translates an absolute screen position to position value for a control.

Destroys the object.

Removes a column from the grid.

If no column is passed, the last column is removed. The col argument can
be either a column index or a dColumn instance.

Run the incremental search.

Places this object behind all others.

Set all child object properties to the passed value.

No bad effects will happen if the property doesn't apply to a child - only
children with the property will have their property updated.

If 'recurse' is True, setAll() will be called on each child as well.

If 'filt' is not empty, only children that match the expression in 'filt'
will be affected. The expression will be evaluated assuming the child
object is prefixed to the expression. For example, if you want to only
affect objects that are instances of dButton, you'd call::

	form.setAll("FontBold", True, filt="BaseClass == dabo.ui.dButton")

If the instancesOf sequence is passed, the property will only be set if
the child object is an instance of one of the passed classes.

Sets focus to the object.

Convenience method to let you call this directly on the object.

Sets a group of properties on the object all at once.

You have the following options for sending the properties:
	
	1) Property/Value pair dictionary
	2) Keyword arguments
	3) Both

The following examples all do the same thing::

	self.setProperties(FontBold=True, ForeColor="Red")
	self.setProperties({"FontBold": True, "ForeColor": "Red"})
	self.setProperties({"FontBold": True}, ForeColor="Red")

Sets a group of properties on the object all at once. This
is different from the regular setProperties() method because
it only accepts a dict containing prop:value pairs, and it
assumes that the value is always a string. It will convert
the value to the correct type for the property, and then set
the property to that converted value. If the value needs to be evaluated
in a specific namespace, pass that as the 'context' parameter.

Explicitly set the height of a specific row in the grid. If
SameSizeRows is True, all rows will be affected.

Tells the object's ControllingSizer to adjust the requested property.

Convenience method for setting multiple sizer item properties at once. The
dict should have the property name as the key and the desired new value
as the associated value.

Set the attributes for table display

Make the object visible.

If the column is not shown and visible=True, show it. Likewise
but opposite if visible=False.

If this object is inside of any paged control, it will force all containing
paged controls to switch to the page that contains this object.

Display a context menu (popup) at the specified position.

If no position is specified, the menu will be displayed at the current
mouse position.

If release is True (the default), the menu will be released after the user
has dismissed it.

Set the width of the grid equal to the sum of the widths	of the columns.

If scrollBarFudge is True, additional space will be added to account for
the width of the vertical scrollbar.

Set the height of the grid equal to the sum of the heights of the rows.

This is intended to be used only when the number of rows is expected to be
low. Set maxHeight to whatever you want the maximum height to be.

Hook method used in subclasses for custom sorting.

When the DataField is set for a column, it needs to set the corresponding
value of its DataType property. Will return the Python data type, or None if
there is no bizobj, or no DataStructure info available in the bizobj.

Remove a previously registered event binding.

Removes all registrations that exist for the given binding for this
object. If event is None, all bindings for the passed function are
removed. If function is None, all bindings for the passed event are
removed. If both event and function are None, all event bindings are
removed.

Unbind a previously bound key combination.

Fail silently if the key combination didn't exist already.

Unlocks the visual updates to the control.

Use in conjunction with lockDisplay(), when you are doing lots of things
that would result in lengthy screen updates.

Since lockDisplay() may be called several times on an object, calling
unlockDisplay() will "undo" one locking call. When all locks have been
removed, repainting of the display will resume.

Immediately unlocks the display, no matter how many previous
lockDisplay calls have been made. Useful in a callAfterInterval()
construction to avoid flicker.

Call this when your datasource or dataset has changed to get the grid showing
the proper number of rows with current data.