wxGlade tutorial - wx.window base class

(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. Save it as simple2-glade.wxg. In the main (toolbox) window

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

About the wx.Window base class

wx.Window is the base class for all windows and represents any visible object on the screen. All controls, top level windows and so on are wx.Windows. Sizers and device contexts are not however, as they don't appear on screen themselves. wx.Window's descendents inherit its methods. This means that if you are looking for a method for a particular widget, it may be documented under wx.Window rather than with the widget's own methods.

There are two reference documents which describe the wxPython API. The main document is the wxWidgets manual ( It is presented using C syntax, so wx.Window appears as wxWindow, and method appears as member. A translation in Python syntax (the wxPython API) is available at, but may be out-of-date. You may find it helpful to refer to both documents. Look for wxWindow's methods in


SetTitle() method

Look up wx.Window's SetTitle() method. You should find


virtual void SetTitle(const wxString& title)

Sets the window's title. Applicable only to frames and dialogs.



            The window's title.

in the wxWidgets manual and

SetTitle(self, title)

Sets the window's title. Applicable only to frames and dialogs.


in the wxPython API. These tell you that SetTitle() sets the window's title and has one string parameter.

In the wxGlade Tree window, double-click on frame_1(MyFrame). This opens the Design window and the Properties window for frame_1. Its class MyFrame was derived from wx.Frame which in turn was derived from wx.Window. The SetTitle() method is set in the Widget tab of the Properties window. Set the title to "simple2-glade":

You can check the result without having to generate and run the Python code:

SetSize() method

Sets the size of the window in pixels. Parameters:

The SetTitle() method is set in the Common tab of the Properties window. Set width to 300 and height to 250:

Check the result:

SetToolTipString() method

Attach a tooltip to the window. Parameters:

The SetToolTipString() method is set in the Common tab of the Properties window. Set the tooltip text to "This is a frame".

Check the result:

Move the mouse pointer anywhere inside the frame to activate the tooltip.

Generate the Python code

Save the project. In the main window

In the Tree window, select Application.

In the Properties window, enter a new filename for the python file.

Click on

Run the application

Change to the directory containing Run the file from the commandline




Alternatively you can open the file in Idle and press F5 to run it.

Check the generated code

Open the file in Idle or a text editor. Look at MyFrame's __set_properties() method (lines 17-22). Here are the three methods that you set in wxGlade.

   1     def __set_properties(self):
   2         # begin wxGlade: MyFrame.__set_properties
   3         self.SetTitle("simple2-glade")
   4         self.SetSize((300, 250))
   5         self.SetToolTipString("This is a frame")
   6         # end wxGlade

Using methods not available in wxGlade

You can add code manually to wxGlade will not overwrite your added code providing that you untick "Overwrite existing sources" before you regenerate the code and write your added code outside the begin wxGlade ... end wxGlade blocks.

For example, you can set the cursor to a different stock cursor. (Look up the "wx.Cursor" class and the wx.Window SetCursor() method.)

Edit and insert after line 21 but outside the begin wxGlade ... end wxGlade block:

   1         self.SetCursor(wx.StockCursor(wx.CURSOR_NO_ENTRY))

Save and run it. Move the mouse pointer inside the frame to see the new cursor.

Appendix: The complete code

   1 #!/usr/bin/env python
   2 # -*- coding: ISO-8859-1 -*-
   3 # generated by wxGlade 0.4.1 on Mon Mar 27 15:47:00 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)
  13         self.__set_properties()
  14         self.__do_layout()
  15         # end wxGlade
  17     def __set_properties(self):
  18         # begin wxGlade: MyFrame.__set_properties
  19         self.SetTitle("simple2-glade")
  20         self.SetSize((300, 250))
  21         self.SetToolTipString("This is a frame")
  22         # end wxGlade
  23         self.SetCursor(wx.StockCursor(wx.CURSOR_NO_ENTRY))
  25     def __do_layout(self):
  26         # begin wxGlade: MyFrame.__do_layout
  27         sizer_1 = wx.BoxSizer(wx.VERTICAL)
  28         self.SetAutoLayout(True)
  29         self.SetSizer(sizer_1)
  30         self.Layout()
  31         # end wxGlade
  33 # end of class MyFrame
  36 class MyApp(wx.App):
  37     def OnInit(self):
  38         wx.InitAllImageHandlers()
  39         frame_1 = MyFrame(None, -1, "")
  40         self.SetTopWindow(frame_1)
  41         frame_1.Show()
  42         return 1
  44 # end of class MyApp
  46 if __name__ == "__main__":
  47     app = MyApp(0)
  48     app.MainLoop()

WxGladeWxWindow (last edited 2009-08-05 16:41:14 by 84-253-237-195)

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