wxGlade manual

Marcello Semboli

Alberto Griggio

Carsten Grohmann


Table of Contents

Preface
Contact
License
1. Introduction to wxGlade
What is wxGlade?
What can you do with wxGlade?
What is wxGlade NOT?
Requirements and Supported Platforms
Installation Requirements
Installation
Download
Installing on Microsoft Windows
Installing on Unix/Unix-like Operating Systems
Installing from Source
Configuring wxGlade
Preferences Dialog
Environment Variables
Configuration Files
Deprecated Features
Troubleshooting and Error Handling
Troubleshooting
Error Messages
How to Report a Bug
2. Exploring wxGlade
Quick Example
Basics of wxGlade
Escape Sequences
Best Practice
Language Specific Peculiarities
Python
Lisp
XRC
Command Line Invocation
Using the Source Code
Full Control by wxGlade
Shared Control
Output Path and Filenames
Automatically Created wxApp Instances
Compiling C++ Code
Handling XRC Files
3. 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
4. Supported widgets
Introduction
Specifying the Path of Bitmaps
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
5. Menu, Statusbar and Toolbar
Introduction
Menu
Statusbar
Toolbar
6. wxGlade technical notes
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
Contributing to wxGlade
Coding conventions
Testing
Commit Messages
7. Installing and Designing own Widget Plugins
Widgets Packages
Create a ZIP Package
Installing Widget Plugins Locally
Designing own Widget Plugins
Widget Initialisation
A. Abbreviations
B. Copyrights and Trademarks
C. wxGlade License Agreement
D. Licenses and Acknowledgements for Incorporated Software
OrderedDict
E. The wxGlade Icon

List of Figures

1.1. wxGlade windows
1.2. Starting wxGlade on Windows at C:\Program Files\wxGlade
1.3. Starting wxGlade on Windows at /opt/wxglade/bin/wxglade
1.4. wxGlade preferences dialog
1.5. An error dialog example
3.1. The Main Palette
3.2. The Tree Window
3.3. The menu for a widget
3.4. The menu for a sizer
3.5. The Design Window
3.6. Project Properties - Application settings
3.7. Project Properties - Language settings
3.8. Common Properties
3.9. Changing Common Properties
3.10. Common Properties - A subclassed widget (default behaviour)
3.11. Common Properties - Base class(es) entry
3.12. Common Properties - Variable assignment
3.13. Layout Properties
3.14. Widget Properties
3.15. Widget Properties - Don't generate code for this class
3.16. Widget Properties - Styles Tooltip
3.17. Events Properties
3.18. Events Properties - Event handler name added
3.19. Code Properties - Extra code and extra properties
3.20. Code Properties - Set extra property
4.1. Widget Properties for a Custom Widget
4.2. Widget Tree
4.3. SpeedMeter Properties
4.4. Preview
5.1. Menu editor
5.2. Statusbar properties
5.3. Toolbar editor

List of Tables

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

List of Examples

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