]> git.saurik.com Git - wxWidgets.git/blob - wxPython/demo/ComboBox.py
docstring fix
[wxWidgets.git] / wxPython / demo / ComboBox.py
1
2 import wx
3
4 #---------------------------------------------------------------------------
5
6 class TestComboBox(wx.Panel):
7 def OnSetFocus(self, evt):
8 print "OnSetFocus"
9 evt.Skip()
10
11 def OnKillFocus(self, evt):
12 print "OnKillFocus"
13 evt.Skip()
14
15 def __init__(self, parent, log):
16 self.log = log
17 wx.Panel.__init__(self, parent, -1)
18
19 sampleList = ['zero', 'one', 'two', 'three', 'four', 'five',
20 #'this is a long item that needs a scrollbar...',
21 'six', 'seven', 'eight']
22
23 wx.StaticText(self, -1, "This example uses the wx.ComboBox control.", (8, 10))
24 wx.StaticText(self, -1, "Select one:", (15, 50), (75, 18))
25
26 # This combobox is created with a preset list of values.
27 cb = wx.ComboBox(
28 self, 500, "default value", (90, 50),
29 (95, -1), sampleList, wx.CB_DROPDOWN #|wxTE_PROCESS_ENTER
30 )
31
32 self.Bind(wx.EVT_COMBOBOX, self.EvtComboBox, cb)
33 self.Bind(wx.EVT_TEXT, self.EvtText, cb)
34 self.Bind(wx.EVT_TEXT_ENTER, self.EvtTextEnter, cb)
35 cb.Bind(wx.EVT_SET_FOCUS, self.OnSetFocus)
36 cb.Bind(wx.EVT_KILL_FOCUS, self.OnKillFocus)
37
38 # Once the combobox is set up, we can append some more data to it.
39 cb.Append("foo", "This is some client data for this item")
40
41 # This combobox is created with no values initially.
42 cb = wx.ComboBox(
43 self, 501, "default value", (90, 80), (95, -1), [], wx.CB_DROPDOWN)
44
45 # Here we dynamically add our values to the second combobox.
46 for item in sampleList:
47 cb.Append(item, item.upper())
48
49 self.Bind(wx.EVT_COMBOBOX, self.EvtComboBox, cb)
50
51 # When the user selects something, we go here.
52 def EvtComboBox(self, evt):
53 cb = evt.GetEventObject()
54 data = cb.GetClientData(evt.GetSelection())
55 self.log.WriteText('EvtComboBox: %s\nClientData: %s\n' % (evt.GetString(), data))
56
57 if evt.GetString() == 'one':
58 self.log.WriteText("You follow directions well!\n\n")
59
60 # Capture events every time a user hits a key in the text entry field.
61 def EvtText(self, evt):
62 self.log.WriteText('EvtText: %s\n' % evt.GetString())
63 evt.Skip()
64
65 # Capture events when the user types something into the control then
66 # hits ENTER.
67 def EvtTextEnter(self, evt):
68 self.log.WriteText('EvtTextEnter: %s' % evt.GetString())
69 evt.Skip()
70
71 #---------------------------------------------------------------------------
72
73 def runTest(frame, nb, log):
74 win = TestComboBox(nb, log)
75 return win
76
77 #---------------------------------------------------------------------------
78
79
80 overview = """\
81 A ComboBox is like a combination of an edit control and a listbox. It can be
82 displayed as static list with editable or read-only text field; or a drop-down
83 list with text field; or a drop-down list without a text field.
84
85 This example shows both a preset ComboBox and one that is dynamically created
86 (that is, it is initially empty but then we 'grow' it out of program-supplied
87 data). The former is common for read-only controls.
88
89 This example also shows the two form factors for the ComboBox. The first is more
90 common, and resembles a Choice control. The latter, although less common, shows
91 how all the values in the ComboBox can be visible, yet the functionality is the
92 same for both.
93
94 Finally, this demo shows how event handling can differ. The first ComboBox is set
95 up to handle EVT_TEXT_ENTER events, in which text is typed in and then ENTER is
96 hit by the user. This allows the user to enter a line of text which can then be
97 processed by the program. EVT_TEXT can also be processed, but in that case the
98 event is generated every time that the user hits a key in the ComboBox entry field.
99
100 """
101
102 #---------------------------------------------------------------------------
103
104 if __name__ == '__main__':
105 import sys,os
106 import run
107 run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
108