wxGlade manual

Marcello Semboli

Alberto Griggio

Carsten Grohmann

Table of Contents

1. Getting Started
What is wxGlade?
What can you do with wxGlade?
What is wxGlade NOT?
2. Installation
Requirements and Supported Platforms
Installing wxGlade
Requirements for Building Own Packages
Installing on Microsoft Windows
Installing on Unix/Unix-like Operating Systems
Installing from Source
3. Running wxGlade
Known Platforms
Command Line Invocation
Configuring wxGlade
Preferences Dialog
Environment Variables
Configuration Files
Deprecated Features
Overwrite existing sources
Troubleshooting and Error Handling
Error Messages
How to Report a Bug
4. Working with wxGlade
First Steps
Quick Example
Next Steps
Escape Sequences
Best Practice
Language Specific Peculiarities
Using the Source Code
Handling XRC Files
5. wxGlade User Interface
Main Palette
Tree Window
Design Window
Properties Window
Application Properties
Common Properties
Layout Properties
Widget Properties
Events Properties
Code Properties
The wxGlade Menu
The FILE Menu
The VIEW Menu
The HELP Menu
6. Supported widgets
Specifying the Path of Bitmaps
Bitmap Path
statement var:
statement empty:
statement art:
statement code:
Menubar, Statusbar and Toolbar
Widget List
Dialog or Panel
Splitter Window
Calendar Control
Check List Box
Check Box
Combo Box
Date Picker Control
Generic Calendar Control
Hyperlink Control
List Box
List Control
Property Grid Manager
Radio Box
Spin Control
Static Line
Static Bitmap
Static Text
Text Control
Tree Control
Custom Widget
7. wxGlade technical notes
Installing and Designing own Widget Plugins
Widgets Packages
Create a ZIP Package
Installing Widget Plugins Locally
Designing own Widget Plugins
Contributing to wxGlade
Coding conventions
Commit Messages
Incomplete and outdated parts
Adding a top-level Widget
Adding a top-level Sizer
Adding a Normal Widget/Sizer
Changing the Value of a Property
Saving the Design
Loading an App from a XML file
Generating the Source Code
A. Glossary of Terms, Abbreviations, and Acronyms
B. Copyrights, Licenses and Trademarks
wxGlade License Agreement
Licenses and Acknowledgements for Incorporated Software
C. The wxGlade Icon

List of Figures

1.1. wxGlade windows
2.1. Starting wxGlade on Windows at C:\Program Files\wxGlade
2.2. Starting wxGlade on Linux at /opt/wxglade/bin/wxglade
3.1. wxGlade preferences dialog
3.2. An error dialog example
5.1. The Main Palette
5.2. The Tree Window
5.3. The menu for a widget
5.4. The menu for a sizer
5.5. The Design Window
5.6. Project Properties - Application settings
5.7. Project Properties - Language settings
5.8. Common Properties
5.9. Changing Common Properties
5.10. Common Properties - A subclassed widget (default behaviour)
5.11. Common Properties - Base class(es) entry
5.12. Common Properties - Variable assignment
5.13. Layout Properties
5.14. Widget Properties
5.15. Widget Properties - Don't generate code for this class
5.16. Widget Properties - Styles Tooltip
5.17. Events Properties
5.18. Events Properties - Event handler name added
5.19. Code Properties - Extra code and extra properties
5.20. Code Properties - Set extra property
6.1. Menu editor
6.2. Statusbar properties
6.3. Toolbar editor
6.4. Widget Properties for a Custom Widget
6.5. Widget Tree
6.6. SpeedMeter Properties
6.7. Preview

List of Tables

4.1. Interaction between properties to generate different types of start code

List of Examples

2.1. Installing wxGlade at /opt/wxglade
4.1. Correct entered wx constant
4.2. Detailed application start code in Perl
4.3. Simplified application start code in Perl
4.4. Compiling a single file C++ project on Linux
4.5. Compiling a multi file C++ project on Linux
4.6. Converting a XRC file into a wxGlade project
4.7. wxPython code to load and show a XRC resource
5.1. Generated Python code of a subclassed widget
5.2. Generated Python code of a widget with two base classes
5.3. Generated Python code for a variable assignment
5.4. Generated Python code of an EVT_TEXT event handler stub at line 12
5.5. Generated Python code for setting property MaxLength to 10 at line 14
6.1. wxBitmap object with the typed string as bitmap path
6.2. wxBitmap object with the variable name as bitmap path
6.3. Create an empty wxBitmap with width of 32 and height of 32
6.4. Create a bitmap using wxArtProvider
6.5. wxSomeWidget needs a wxBitmap as an argument
6.6. Generated C++ code for the custom widget shown above
6.7. Widget Custom Widget - AGW SpeedMeter
7.1. Directory package
7.2. ZIP package