phoenix_title wx.grid.GridCellEditor

This class is responsible for providing and manipulating the in-place edit controls for the grid.

Instances of wx.grid.GridCellEditor (actually, instances of derived classes since it is an abstract class) can be associated with the cell attributes for individual cells, rows, columns, or even for the entire grid.


class_hierarchy Class Hierarchy

Inheritance diagram for class GridCellEditor:

method_summary Methods Summary

__init__

Default constructor.

ApplyEdit

Effectively save the changes in the grid.

BeginEdit

Fetch the value from the table and prepare the edit control to begin editing.

Clone

Create a new object which is the copy of this one.

Create

Creates the actual edit control.

Destroy

Final cleanup.

EndEdit

End editing the cell.

GetControl

Get the wx.Control used by this editor.

GetValue

Returns the value currently in the editor control.

HandleReturn

Some types of controls on some platforms may need some help with the Return key.

IsCreated

Returns True if the edit control has been created.

PaintBackground

Draws the part of the cell not occupied by the control: the base class version just fills it with background colour from the attribute.

Reset

Reset the value in the control back to its starting value.

SetControl

Set the wx.Control that will be used by this cell editor for editing the value.

SetSize

Size and position the edit control.

Show

Show or hide the edit control, use the specified attributes to set colours/fonts for it.

StartingClick

If the editor is enabled by clicking on the cell, this method will be called.

StartingKey

If the editor is enabled by pressing keys on the grid, this will be called to let the editor do something about that first key if desired.

~wxGridCellEditor

The destructor is private because only DecRef can delete us.


property_summary Properties Summary

Control

See GetControl and SetControl

Value

See GetValue


api Class API

class wx.grid.GridCellEditor(ClientDataContainer, RefCounter)

Possible constructors:

GridCellEditor()

This class is responsible for providing and manipulating the in-place edit controls for the grid.


Methods

__init__(self)

Default constructor.



ApplyEdit(self, row, col, grid)

Effectively save the changes in the grid.

This function should save the value of the control in the grid. It is called only after EndEdit returns True.

Parameters


BeginEdit(self, row, col, grid)

Fetch the value from the table and prepare the edit control to begin editing.

This function should save the original value of the grid cell at the given row and col and show the control allowing the user to change it.

Parameters

See also

EndEdit



Clone(self)

Create a new object which is the copy of this one.

Return type

wx.grid.GridCellEditor



Create(self, parent, id, evtHandler)

Creates the actual edit control.

Parameters


Destroy(self)

Final cleanup.



EndEdit(self, row, col, grid, oldval)

End editing the cell.

This function must check if the current value of the editing cell is valid and different from the original value in its string form. If not then simply return None. If it has changed then this method should save the new value so that ApplyEdit can apply it later and the string representation of the new value should be returned.

Notice that this method shoiuld not modify the grid as the change could still be vetoed.



GetControl(self)

Get the wx.Control used by this editor.

Return type

Control



GetValue(self)

Returns the value currently in the editor control.

Return type

string



HandleReturn(self, event)

Some types of controls on some platforms may need some help with the Return key.

Parameters

event (wx.KeyEvent) –



IsCreated(self)

Returns True if the edit control has been created.

Return type

bool



PaintBackground(self, dc, rectCell, attr)

Draws the part of the cell not occupied by the control: the base class version just fills it with background colour from the attribute.

Parameters


Reset(self)

Reset the value in the control back to its starting value.



SetControl(self, control)

Set the wx.Control that will be used by this cell editor for editing the value.

Parameters

control (wx.Control) –



SetSize(self, rect)

Size and position the edit control.

Parameters

rect (wx.Rect) –



Show(self, show, attr=None)

Show or hide the edit control, use the specified attributes to set colours/fonts for it.

Parameters


StartingClick(self)

If the editor is enabled by clicking on the cell, this method will be called.



StartingKey(self, event)

If the editor is enabled by pressing keys on the grid, this will be called to let the editor do something about that first key if desired.

Parameters

event (wx.KeyEvent) –



~wxGridCellEditor(self)

The destructor is private because only DecRef can delete us.


Properties

Control

See GetControl and SetControl



Value

See GetValue