]> git.saurik.com Git - wxWidgets.git/blob - wxPython/demo/GridCustEditor.py
Applied patch [ 1284335 ] doc update for wxString::operator[]
[wxWidgets.git] / wxPython / demo / GridCustEditor.py
1
2 import string
3
4 import wx
5 import wx.grid as gridlib
6
7 #---------------------------------------------------------------------------
8 class MyCellEditor(gridlib.PyGridCellEditor):
9 """
10 This is a sample GridCellEditor that shows you how to make your own custom
11 grid editors. All the methods that can be overridden are shown here. The
12 ones that must be overridden are marked with "*Must Override*" in the
13 docstring.
14
15 Notice that in order to call the base class version of these special
16 methods we use the method name preceded by "base_". This is because these
17 methods are "virtual" in C++ so if we try to call wx.GridCellEditor.Create
18 for example, then when the wxPython extension module tries to call
19 ptr->Create(...) then it actually calls the derived class version which
20 looks up the method in this class and calls it, causing a recursion loop.
21 If you don't understand any of this, don't worry, just call the "base_"
22 version instead.
23 """
24 def __init__(self, log):
25 self.log = log
26 self.log.write("MyCellEditor ctor\n")
27 gridlib.PyGridCellEditor.__init__(self)
28
29
30 def Create(self, parent, id, evtHandler):
31 """
32 Called to create the control, which must derive from wx.Control.
33 *Must Override*
34 """
35 self.log.write("MyCellEditor: Create\n")
36 self._tc = wx.TextCtrl(parent, id, "")
37 self._tc.SetInsertionPoint(0)
38 self.SetControl(self._tc)
39
40 if evtHandler:
41 self._tc.PushEventHandler(evtHandler)
42
43
44 def SetSize(self, rect):
45 """
46 Called to position/size the edit control within the cell rectangle.
47 If you don't fill the cell (the rect) then be sure to override
48 PaintBackground and do something meaningful there.
49 """
50 self.log.write("MyCellEditor: SetSize %s\n" % rect)
51 self._tc.SetDimensions(rect.x, rect.y, rect.width+2, rect.height+2,
52 wx.SIZE_ALLOW_MINUS_ONE)
53
54
55 def Show(self, show, attr):
56 """
57 Show or hide the edit control. You can use the attr (if not None)
58 to set colours or fonts for the control.
59 """
60 self.log.write("MyCellEditor: Show(self, %s, %s)\n" % (show, attr))
61 self.base_Show(show, attr)
62
63
64 def PaintBackground(self, rect, attr):
65 """
66 Draws the part of the cell not occupied by the edit control. The
67 base class version just fills it with background colour from the
68 attribute. In this class the edit control fills the whole cell so
69 don't do anything at all in order to reduce flicker.
70 """
71 self.log.write("MyCellEditor: PaintBackground\n")
72
73
74 def BeginEdit(self, row, col, grid):
75 """
76 Fetch the value from the table and prepare the edit control
77 to begin editing. Set the focus to the edit control.
78 *Must Override*
79 """
80 self.log.write("MyCellEditor: BeginEdit (%d,%d)\n" % (row, col))
81 self.startValue = grid.GetTable().GetValue(row, col)
82 self._tc.SetValue(self.startValue)
83 self._tc.SetInsertionPointEnd()
84 self._tc.SetFocus()
85
86 # For this example, select the text
87 self._tc.SetSelection(0, self._tc.GetLastPosition())
88
89
90 def EndEdit(self, row, col, grid):
91 """
92 Complete the editing of the current cell. Returns True if the value
93 has changed. If necessary, the control may be destroyed.
94 *Must Override*
95 """
96 self.log.write("MyCellEditor: EndEdit (%d,%d)\n" % (row, col))
97 changed = False
98
99 val = self._tc.GetValue()
100
101 if val != self.startValue:
102 changed = True
103 grid.GetTable().SetValue(row, col, val) # update the table
104
105 self.startValue = ''
106 self._tc.SetValue('')
107 return changed
108
109
110 def Reset(self):
111 """
112 Reset the value in the control back to its starting value.
113 *Must Override*
114 """
115 self.log.write("MyCellEditor: Reset\n")
116 self._tc.SetValue(self.startValue)
117 self._tc.SetInsertionPointEnd()
118
119
120 def IsAcceptedKey(self, evt):
121 """
122 Return True to allow the given key to start editing: the base class
123 version only checks that the event has no modifiers. F2 is special
124 and will always start the editor.
125 """
126 self.log.write("MyCellEditor: IsAcceptedKey: %d\n" % (evt.GetKeyCode()))
127
128 ## We can ask the base class to do it
129 #return self.base_IsAcceptedKey(evt)
130
131 # or do it ourselves
132 return (not (evt.ControlDown() or evt.AltDown()) and
133 evt.GetKeyCode() != wx.WXK_SHIFT)
134
135
136 def StartingKey(self, evt):
137 """
138 If the editor is enabled by pressing keys on the grid, this will be
139 called to let the editor do something about that first key if desired.
140 """
141 self.log.write("MyCellEditor: StartingKey %d\n" % evt.GetKeyCode())
142 key = evt.GetKeyCode()
143 ch = None
144 if key in [ wx.WXK_NUMPAD0, wx.WXK_NUMPAD1, wx.WXK_NUMPAD2, wx.WXK_NUMPAD3,
145 wx.WXK_NUMPAD4, wx.WXK_NUMPAD5, wx.WXK_NUMPAD6, wx.WXK_NUMPAD7,
146 wx.WXK_NUMPAD8, wx.WXK_NUMPAD9
147 ]:
148
149 ch = ch = chr(ord('0') + key - wx.WXK_NUMPAD0)
150
151 elif key < 256 and key >= 0 and chr(key) in string.printable:
152 ch = chr(key)
153 if not evt.ShiftDown():
154 ch = ch.lower()
155
156 if ch is not None:
157 # For this example, replace the text. Normally we would append it.
158 #self._tc.AppendText(ch)
159 self._tc.SetValue(ch)
160 self._tc.SetInsertionPointEnd()
161 else:
162 evt.Skip()
163
164
165 def StartingClick(self):
166 """
167 If the editor is enabled by clicking on the cell, this method will be
168 called to allow the editor to simulate the click on the control if
169 needed.
170 """
171 self.log.write("MyCellEditor: StartingClick\n")
172
173
174 def Destroy(self):
175 """final cleanup"""
176 self.log.write("MyCellEditor: Destroy\n")
177 self.base_Destroy()
178
179
180 def Clone(self):
181 """
182 Create a new object which is the copy of this one
183 *Must Override*
184 """
185 self.log.write("MyCellEditor: Clone\n")
186 return MyCellEditor(self.log)
187
188
189 #---------------------------------------------------------------------------
190 class GridEditorTest(gridlib.Grid):
191 def __init__(self, parent, log):
192 gridlib.Grid.__init__(self, parent, -1)
193 self.log = log
194
195 self.CreateGrid(10, 3)
196
197 # Somebody changed the grid so the type registry takes precedence
198 # over the default attribute set for editors and renderers, so we
199 # have to set null handlers for the type registry before the
200 # default editor will get used otherwise...
201 #self.RegisterDataType(wxGRID_VALUE_STRING, None, None)
202 #self.SetDefaultEditor(MyCellEditor(self.log))
203
204 # Or we could just do it like this:
205 #self.RegisterDataType(wx.GRID_VALUE_STRING,
206 # wx.GridCellStringRenderer(),
207 # MyCellEditor(self.log))
208 # )
209
210 # but for this example, we'll just set the custom editor on one cell
211 self.SetCellEditor(1, 0, MyCellEditor(self.log))
212 self.SetCellValue(1, 0, "Try to edit this box")
213
214 # and on a column
215 attr = gridlib.GridCellAttr()
216 attr.SetEditor(MyCellEditor(self.log))
217 self.SetColAttr(2, attr)
218 self.SetCellValue(1, 2, "or any in this column")
219
220 self.SetColSize(0, 150)
221 self.SetColSize(1, 150)
222 self.SetColSize(2, 150)
223
224
225 #---------------------------------------------------------------------------
226
227 class TestFrame(wx.Frame):
228 def __init__(self, parent, log):
229 wx.Frame.__init__(self, parent, -1, "Custom Grid Cell Editor Test",
230 size=(640,480))
231 grid = GridEditorTest(self, log)
232
233 #---------------------------------------------------------------------------
234
235 if __name__ == '__main__':
236 import sys
237 app = wx.PySimpleApp()
238 frame = TestFrame(None, sys.stdout)
239 frame.Show(True)
240 app.MainLoop()
241
242