wxGlade manual
		Next

wxGlade manual

Marcello Semboli

Alberto Griggio

Carsten Grohmann

Table of Contents

Contact
License

1. Getting Started

What is wxGlade?

What can you do with wxGlade?
What is wxGlade NOT?

2. Installation

Requirements and Supported Platforms

Installation

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

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

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

6. Supported widgets

Introduction

Specifying the Path of Bitmaps

Bitmap Path
statement “var:”
statement “empty:”
statement “art:”
statement “code:”

Menu, 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

wxGlade License Agreement

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

		Next
		Preface