]> git.saurik.com Git - wxWidgets.git/blob - wxPython/demo/ToolBar.py
Docsrings for wxSplitterWindow
[wxWidgets.git] / wxPython / demo / ToolBar.py
1
2 import wx
3 import images
4
5 #---------------------------------------------------------------------------
6
7 class TestToolBar(wx.Frame):
8 def __init__(self, parent, log):
9 wx.Frame.__init__(self, parent, -1, 'Test ToolBar', size=(500, 300))
10 self.log = log
11 self.timer = None
12 self.Bind(wx.EVT_CLOSE, self.OnCloseWindow)
13
14 wx.Window(self, -1).SetBackgroundColour(wx.NamedColour("WHITE"))
15
16 # Use the wxFrame internals to create the toolbar and associate it all
17 # in one tidy method call.
18 tb = self.CreateToolBar( wx.TB_HORIZONTAL
19 | wx.NO_BORDER
20 | wx.TB_FLAT
21 | wx.TB_TEXT
22 )
23
24 # Here's a 'simple' toolbar example, and how to bind it using SetToolBar()
25 #tb = wx.ToolBarSimple(self, -1, wx.DefaultPosition, wx.DefaultSize,
26 # wx.TB_HORIZONTAL | wx.NO_BORDER | wx.TB_FLAT)
27 #self.SetToolBar(tb)
28 # But we're doing it a different way here.
29
30 log.write("Default toolbar tool size: %s\n" % tb.GetToolBitmapSize())
31
32 self.CreateStatusBar()
33
34 tb.AddSimpleTool(10, images.getNewBitmap(), "New", "Long help for 'New'")
35 #tb.AddLabelTool(10, "New", images.getNewBitmap(), shortHelp="New", longHelp="Long help for 'New'")
36 self.Bind(wx.EVT_TOOL, self.OnToolClick, id=10)
37 self.Bind(wx.EVT_TOOL_RCLICKED, self.OnToolRClick, id=10)
38
39 tb.AddSimpleTool(20, images.getOpenBitmap(), "Open", "Long help for 'Open'")
40 self.Bind(wx.EVT_TOOL, self.OnToolClick, id=20)
41 self.Bind(wx.EVT_TOOL_RCLICKED, self.OnToolRClick, id=20)
42
43 tb.AddSeparator()
44 tb.AddSimpleTool(30, images.getCopyBitmap(), "Copy", "Long help for 'Copy'")
45 self.Bind(wx.EVT_TOOL, self.OnToolClick, id=30)
46 self.Bind(wx.EVT_TOOL_RCLICKED, self.OnToolRClick, id=30)
47
48 tb.AddSimpleTool(40, images.getPasteBitmap(), "Paste", "Long help for 'Paste'")
49 self.Bind(wx.EVT_TOOL, self.OnToolClick, id=40)
50 self.Bind(wx.EVT_TOOL_RCLICKED, self.OnToolRClick, id=40)
51
52 tb.AddSeparator()
53
54 tool = tb.AddCheckTool(50, images.getTog1Bitmap(),
55 shortHelp="Toggle this")
56 self.Bind(wx.EVT_TOOL, self.OnToolClick, id=50)
57
58 ## tb.AddCheckTool(60, images.getTog1Bitmap(), images.getTog2Bitmap(),
59 ## shortHelp="Toggle with 2 bitmaps")
60 ## self.Bind(EVT_TOOL, self.OnToolClick, id=60)
61
62 self.Bind(wx.EVT_TOOL_ENTER, self.OnToolEnter)
63 self.Bind(wx.EVT_TOOL_RCLICKED, self.OnToolRClick) # Match all
64 self.Bind(wx.EVT_TIMER, self.OnClearSB)
65
66 tb.AddSeparator()
67 cbID = wx.NewId()
68
69 tb.AddControl(
70 wx.ComboBox(
71 tb, cbID, "", choices=["", "This", "is a", "wxComboBox"],
72 size=(150,-1), style=wx.CB_DROPDOWN
73 ))
74
75 self.Bind(wx.EVT_COMBOBOX, self.OnCombo, id=cbID)
76 tb.AddControl(wx.TextCtrl(tb, -1, "Toolbar controls!!", size=(150, -1)))
77
78 # Final thing to do for a toolbar is call the Realize() method. This
79 # causes it to render (more or less, that is).
80 tb.Realize()
81
82
83 def OnToolClick(self, event):
84 self.log.WriteText("tool %s clicked\n" % event.GetId())
85 tb = self.GetToolBar()
86 tb.EnableTool(10, not tb.GetToolEnabled(10))
87
88 def OnToolRClick(self, event):
89 self.log.WriteText("tool %s right-clicked\n" % event.GetId())
90
91 def OnCombo(self, event):
92 self.log.WriteText("combobox item selected: %s\n" % event.GetString())
93
94 def OnToolEnter(self, event):
95 self.log.WriteText('OnToolEnter: %s, %s\n' % (event.GetId(), event.GetInt()))
96
97 if self.timer is None:
98 self.timer = wx.Timer(self)
99
100 if self.timer.IsRunning():
101 self.timer.Stop()
102
103 self.timer.Start(2000)
104 event.Skip()
105
106
107 def OnClearSB(self, event): # called for the timer event handler
108 self.SetStatusText("")
109 self.timer.Stop()
110 self.timer = None
111
112
113 def OnCloseWindow(self, event):
114 if self.timer is not None:
115 self.timer.Stop()
116 self.timer = None
117 self.Destroy()
118
119 #---------------------------------------------------------------------------
120
121 def runTest(frame, nb, log):
122 win = TestToolBar(frame, log)
123 frame.otherWin = win
124 win.Show(True)
125
126 #---------------------------------------------------------------------------
127
128
129
130 overview = """\
131 wx.ToolBar is a narrow strip of icons on one side of a frame (top, bottom, sides)
132 that acts much like a menu does, except it is always visible. Additionally, actual
133 wxWindows controls, such as wx.TextCtrl or wx.ComboBox, can be added to the toolbar
134 and used from within it.
135
136 Toolbar creation is a two-step process. First, the toolbar is defined using the
137 various Add* methods of wx.ToolBar. Once all is set up, then wx.Toolbar.Realize()
138 must be called to render it.
139
140 wx.Toolbar events are also propogated as Menu events; this is especially handy when
141 you have a menu bar that contains items that carry out the same function. For example,
142 it is not uncommon to have a little 'floppy' toolbar icon to 'save' the current file
143 (whatever it is) as well as a FILE/SAVE menu item that does the same thing. In this
144 case, both events can be captured and acted upon using the same event handler
145 with no ill effects.
146
147 If there are cases where a toolbar icon should *not* be associated with a menu item,
148 use a unique ID to trap it.
149
150 There are a number of ways to create a toolbar for a wx.Frame. wx.Frame.CreateToolBar()
151 does all the work except it adds no buttons at all unless you override the virtual method
152 OnCreateToolBar(). On the other hand, you can just subclass wx.ToolBar and then use
153 wx.Frame.SetToolBar() instead.
154
155 Note that wx.TB_DOCKABLE is only supported under GTK. An attempt to alleviate this
156 is provided in wx.lib.floatbar, but it is not formally supported.
157 """
158
159
160 if __name__ == '__main__':
161 import sys,os
162 import run
163 run.main(['', os.path.basename(sys.argv[0])] + sys.argv[1:])
164