wxGlade Overview

Running wxGlade

Start: To run wxGlade, start the wxglade.py or wxglade.pyw program file with the Python interpreter.

Other Prerequisites: On Windows, the win32 extensions should be installed: https://sourceforge.net/projects/pywin32/

Supported Python and wxPython Versions:
  • The classic wxPython versions 2.8 and 3.0 are supported as well as wxPython Phoenix running under Python 3
  • Phoenix plus Python 2 will probably also work, but this is not tested at all. wxPython 2.8 is generally less tested than the more recent versions.
  • When running Python 3 + Phoenix or Python 2 + Classic, the generated Python code will not be compatible to the other version.

Note

For the best user experience, run wxGlade with your target wxPython revision (i.e. 2.8 or 3.0). If you use a different revision, the Design and Preview window might not look identical to your final program, as some styles are not supported under all revisions.

Program Windows

wxGlade consists of five main windows:

(click on one of the images to see it full size)

wPalette Main Palette window:

This is the main window with the main menu.
There is an icon for each window and control type that can be added to a project.
wTree Tree window:

This window visualizes and allows editing the structure of the project with it’s application, windows, sizers and controls.
On selection of an item, it’s properties will be shown in the Properties window.
wProperties Properties window:

This lets you display and edit the properties of applications, windows and controls.
To edit an item, select it in the Tree or Design window.
wDesign Design window:

This one visualizes the design of the window. It is not 100% identical to the final window.
To open this window, double-click a window’s icon in the Tree window.
  Preview window

A preview of the current window.
It should look 100% identical to the window when it is used in the application.

See also

Reference: Keyboard and Mouse Actions for keyboard shortcuts and mouse actions.

Examples

Before doing anything else, you may want to open an example file showing most of the supported controls:

  • for wxPython 3.0 and Phoenix: examples/AllControls_30.wxg
  • for wxPython 2.8: examples/AllControls_28.wxg

Each example file includes a frame with most of the supported widgets and also a menu bar, a tool bar and a status bar.

Required steps:
  • open the file by dragging it to the main window or by selecting the menu item File->Open
  • double-click “All_Widgets” in the Tree window to open the Design window and have a look around
  • create Python source code:
    • press Ctrl-G or
    • select the toplevel object “Application” and hit the button “Generate Source” in the Properties window
  • press F5 to create a preview