wxGlade tutorial - Events and Buttons

(Contributed by Chris Lale, chrislale AT users DOT berlios DOT de)

Table of Contents:

Create the application in wxglade

Run wxglade. Open the simple project simple-glade.wxg that you created in "first steps" (WxGladeFirstSteps). The project consists of one empty frame. Set the title to "event-glade" and save it as In the main (toolbox) window

The Tree shows that the application contains one frame and a sizer to added automatically by wxGlade.

About the wx.Button class

A button is a control that contains a text string, and is one of the most common elements of a GUI. It may be placed on a dialog box or panel, or indeed almost any other window.

The constructor is __init__(self, parent, id, label, pos, size, style, validator, name), but for simple purposes you only need to specify the first three: parent, id and label.

Look for wx.Button's methods in


Add a button to the sizer

In the wxGlade toolbox window, double-click on Add a button icon. Then click inside the Design window to add the button button_1. Change the button's label to "Click me":

The wx.Button instance method is added to MyFrame's __init()__ method:

   1      self.button_1 = wx.Button(self, -1, "Click me")

The code creates and shows the button.

Check the result:

Create an event handler for the button

An event handler is a piece of code that is executed when an event occurs (eg clicking on a button). wxGlade will create an empty method for this. You must add the instructions by hand after wxGlade has generated the application's code. Make sure that you choose not to overwrite existing code when you generate the application's code, so that you manually added instructions are preserved.

Generate and inspect the code:

The frame's __init__() method now includes a method that binds an EVT_BUTTON event on button_1 to the OnBtn1 method.

   1         self.Bind(wx.EVT_BUTTON, self.OnBtn1, self.button_1)

The OnBtn1 method contains a placeholder line that writes a message to standard output when the button is clicked.

   1     def OnBtn1(self, event): # wxGlade: MyFrame.<event_handler>
   2         print "Event handler `OnBtn1' not implemented"
   3         event.Skip()

Replace this line with code that changes the button's label using wx.Button's SetLabel() method:

   1     def OnBtn1(self, event): # wxGlade: MyFrame.<event_handler>
   2         self.button_1.SetLabel("Ouch!")
   3         event.Skip()

Save and run it.

Stock buttons

The preferred way to create standard buttons is to use a standard ID and an empty label. In this case wxWigets will automatically use a stock label that coresponds to the ID given. In additon, the button will be decorated with stock icons under GTK+ 2.

Create the button using the standard ID for an OK button like this:

   1      self.button_1 = wx.Button(self, -1, "Click me")


   1      self.button_1 = wx.Button(self, wx.ID_OK, "")

Generate the code and run

Appendix: The complete code

   1 #!/usr/bin/env python
   2 # -*- coding: ISO-8859-1 -*-
   3 # generated by wxGlade 0.4.1 on Thu Mar 30 11:13:24 2006
   5 import wx
   7 class MyFrame(wx.Frame):
   8     def __init__(self, *args, **kwds):
   9         # begin wxGlade: MyFrame.__init__
  10         kwds["style"] = wx.DEFAULT_FRAME_STYLE
  11         wx.Frame.__init__(self, *args, **kwds)
  12         self.button_1 = wx.Button(self, wx.ID_OK, "")
  14         self.__set_properties()
  15         self.__do_layout()
  17         self.Bind(wx.EVT_BUTTON, self.OnBtn1, self.button_1)
  18         # end wxGlade
  20     def __set_properties(self):
  21         # begin wxGlade: MyFrame.__set_properties
  22         self.SetTitle("event-glade")
  23         self.SetSize((350, 250))
  24         # end wxGlade
  26     def __do_layout(self):
  27         # begin wxGlade: MyFrame.__do_layout
  28         sizer_1 = wx.BoxSizer(wx.VERTICAL)
  29         sizer_1.Add(self.button_1, 0, wx.ADJUST_MINSIZE, 0)
  30         self.SetAutoLayout(True)
  31         self.SetSizer(sizer_1)
  32         self.Layout()
  33         # end wxGlade
  35     def OnBtn1(self, event): # wxGlade: MyFrame.<event_handler>
  36         self.button_1.SetLabel("Ouch!")
  37         event.Skip()
  39 # end of class MyFrame
  42 class MyApp(wx.App):
  43     def OnInit(self):
  44         wx.InitAllImageHandlers()
  45         frame_1 = MyFrame(None, -1, "")
  46         self.SetTopWindow(frame_1)
  47         frame_1.Show()
  48         return 1
  50 # end of class MyApp
  52 if __name__ == "__main__":
  53     app = MyApp(0)
  54     app.MainLoop()

WxGladeEventsButtons (last edited 2008-03-11 10:50:24 by localhost)

NOTE: To edit pages in this wiki you must be a member of the TrustedEditorsGroup.