wxGlade manual

Marcello Semboli

Alberto Griggio

Carsten Grohmann


Table of Contents

Preface
Contact
License
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
Download
Installing on Microsoft Windows
Installing on Unix/Unix-like Operating Systems
Installing from Source
3. Running wxGlade
Known Platforms
Languages
Command Line Invocation
Configuring wxGlade
Preferences Dialog
Environment Variables
Configuration Files
Deprecated Features
Overwrite existing sources
Troubleshooting and Error Handling
Troubleshooting
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
Styles
Events Properties
Code Properties
The wxGlade Menu
The FILE Menu
The VIEW Menu
The HELP Menu
Shortcuts
6. Supported widgets
Introduction
Specifying the Path of Bitmaps
Bitmap Path
statement var:
statement empty:
statement art:
statement code:
Menubar, Statusbar and Toolbar
Introduction
Menu
Statusbar
Toolbar
Widget List
Frame
Dialog or Panel
Panel
Splitter Window
Notebook
Buttons
Calendar Control
Check List Box
Check Box
Choice
Combo Box
Date Picker Control
Gauge
Generic Calendar Control
Grid
Hyperlink Control
List Box
List Control
Property Grid Manager
Radio Box
Slider
Spin Control
Static Line
Static Bitmap
Static Text
Text Control
Tree Control
Custom Widget
Spacer
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
Testing
Commit Messages
Incomplete and outdated parts
Startup
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
Copyrights
wxGlade License Agreement
Trademarks
Licenses and Acknowledgements for Incorporated Software
OrderedDict
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