GUI Programming with Python: QT Edition
GUI Programming with Python: QT Edition
Boudewijn Rempt
Copyright © 2001 by Commandprompt, Inc
Copyright (c) 2001 by Command Prompt,
Inc. This material may be distributed only subject to the
terms and conditions set forth in the Open Publication
License, v1.0 or later (the latest version is presently
available at http://www.opencontent.org/openpub/).
‘Distribution of substantively modified
versions of this document is prohibited without the explicit
permission of the copyright holder.' to the license reference
or copy.
‘Distribution of the work or derivative
of the work in any standard (paper) book form is prohibited
unless prior permission is obtained from the copyright
holder.' to the license reference or copy.
Although every reasonable effort has been made to
incorporate accurate and useful information into this book,
the copyright holders make no representation about the
suitability of this book or the information therein for any
purpose. It is provided "as is" without expressed
or implied warranty.
Dedication
This book is dedicated to Irina.
- Table of Contents
- Preface
-
- Who is using PyQt
- For whom is this book
intended - How to read this book
- Conventions
- Acknowledgments
- 1. Introduction
-
- Python
- GUI programming with Python
- About the BlackAdder IDE
- I. Introduction to the BlackAdder IDE
-
- 2. Installation
-
- Installing BlackAdder
- Installing
sip and PyQt without BlackAdder
- 3. Interface
-
- Menubar
- Toolbars
- Project management
- BlackAdder Configuration
- Editing
- Python shell
- Conclusion
- 4. Introduction to Python
-
- Programming fundamentals
- The Rules
- Constructions
- Conclusion
- 5. Debugging
-
- Running scripts
- Setting breakpoints
- Stepping along
- Debugging Techniques
- If all else fails
- II. PyQt fundamentals
-
- 6. Qt Concepts
-
- Python, Qt and PyQt
- As simple as they come
- A better Hello World
- Designing forms
- Conclusion
- 7. Signals and Slots in Depth
-
- The concept of signals and slots
- Connecting with signals and slots
- Disconnecting
- A parser-formatter using signals and slots
- Conclusion
- 8. String Objects in Python and Qt
-
- Introduction
- String conversions
- QCString — simple strings in PyQt
- Unicode strings
- 9. Python Objects and Qt Objects
-
- Pointers and references
- Circular references
- Qt objects, Python objects and shadow objects
- References and ownership
- Other C++ objects
- Connecting signals and slots
- Object and class introspection
- 10. Qt Class Hierarchy
-
- Hierarchy
- Base classes
- Application classes
- Widget foundations: QWidget
- Basic widgets
- Advanced widgets
- Layout managers
- Dialogs and Standard Dialogs
- Qt Utility classes and their Python equivalents
- 11. Qt Designer, BlackAdder and uic
-
- Introduction
- Advanced Designer topics
- III. Creating real applications with PyQt
-
- 12. Application Frameworks
-
- Architecture: models, documents and views
- Macro languages
- Project layout
- 13. Actions: menus, toolbars and accelerators
-
- Actions
- Menus
- Toolbars
- Keyboard accelerators
- Setting an application icon
- 14. Automatic testing with PyUnit
-
- About unittests
- Starting out
- A first testcase
- Collecting tests in a test suite
- A more complicated test
- Large projects
- Testing signals and slots
- Conclusion
- 15. A More Complex Framework: Multiple Documents, Multiple
Views -
- Introduction
- Document/View Manager
- The Document Manager
- Document
- View
- The actual application
- Conclusion
- 16. User Interface Paradigms
-
- Tabbed documents
- Back to the MDI windows
- A row of split windows
- A stack of documents
- A more complex view management solution
- Conclusion
- 17. Creating Application Functionality
-
- Introduction
- The view
- The document
- Saving and loading documents
- Undo, redo and other editing functions
- Conclusion
- 18. Application Configuration
-
- Platform differences
- The Python way of handling configuration
settings - Implementing configurations settings for
Kalam - Settings in Qt 3.0
- Conclusion
- 19. Using Dialog Windows
-
- Modal: a preferences dialog
- Non-modal: Search and
replace - Conclusion
- 20. A Macro Language for Kalam
-
- Executing Python code from Python
- Integrating macros with a GUI
- Creating a macro API from an application
- Conclusion
- 21. Drawing on Painters and Canvases
-
- Working with painters and paint devices
- QCanvas
- Conclusion
- 22. Gui Design in the Baroque Age
-
- Types of gui customization
- Faking it with bitmaps
- Creating themes with QStyle
- 23. Drag and drop
-
- Handling drops
- Initiating drags
- Conclusion
- 24. Printing
-
- The QPrinter class
- Adding printing to Kalam
- Putting ink to paper
- Conclusion
- 25. Internationalizing an Application
-
- Translating screen texts
- 26. Delivering your Application
-
- Introduction
- Packaging source
- Starting with distutils.
- Creating Unix RPM packages
- Windows installers
- Desktop integration
- 27. Envoi
- IV. Appendices
-
- A. Reading the Qt Documentation
- B. PyQwt: Python Bindings for Qwt
-
- NumPy
- PyQwt
- C. First Steps with Sip
-
- Introduction
- How sip works
- Creating .sip files
- Things sip can't do
automatically - Where to look to start writing your own
wrappers/bindings - Sip usage and syntax
- Directives
- Accepted C++ / Qt constructs
- SIPLIB Functions
- Bibliography
- Index
- List of Tables
- 1-1. GUI Toolkits for Python
- 7-1. Matrix of
QObject.connect()
combinations. - 10-1. Qt and Python high-level datastructures
- 10-2. Qt and Python network classes
- C-1. C++ access specifiers and sip
- C-2. Command line options
- C-3. Macros in Makefile Templates
- C-4. Flags in member function declaration
- C-1. Error flags in sipParseArgs()
- C-2. Format specifiers for
sipParseArgs()
- List of Figures
- 10-1. Qt Inheritance Hierarchy (only the most important classes)
- 10-2. Object Ownership Hierarchy
- 20-1. Playing with eval()
- 20-2. Playing with exec
- 20-3. Playing with
execfile()
- List of Examples
- 1-1. Bootstrapping a Python application
- 6-1. hello1.py — hello world
- 6-2. hello2.py — a better hello world
- 6-3. fragment from hello3.py
- 6-4. Fragment from hello5.py
- 6-5. Fragment from hello4.py
- 6-6. frmconnect.py
- 6-7. dlgconnect.py — the subclass of the generated form
- 7-1. A stupid button which is not reusable
- 7-2. A simple callback system
- 7-3. A central registry of connected widgets
- 7-4. Connecting a signal to a slot
- 7-5. Connection a dial to a label with signals and slots
- 7-6. Python signals and slots
- 7-7. Python signals and slots with arguments
- 7-8. datasource.py — connecting and disconnecting signals and
slots - 7-9. An XML parser with signals and slots
- 8-1. qstring1.py — conversion from
QString to a Python string. - 8-2. qstring2.py - second try of saving a
QString to a file - 8-3. empty.py - feeding zero bytes to a QCString
- 8-4. null.py - empty and null QCStrings and Python
strings - 8-5. emptyqstring.py - feeding zero bytes to a
QString - 8-6. Loading an utf-8 encoded text
- 8-7. Building a string from single Unicode
characters - 8-8. sitecustomize.py — saving a useful
function from wanton destruction - 8-9. uniqstring3.py - messing with Unicode strings
using utf-8 as default encoding - 8-10. uniqstring1.py - coercing Python strings into
and from QStrings - 8-11. uniqstring2.py - coercing Python strings into and from
QStrings - 9-1. refs.py - showing object references
- 9-2. circular.py - circululululular references
- 9-3. qtrefs1.py — about Qt reference counting
- 9-4. qtrefs2.py - keeping a Qt widget alive
- 9-5. qtrefs3.py - Qt parents and children
- 9-6. Eradicating a widget
- 9-7. children.py - getting the children from a single
parent - 9-8. Iterating over children
- 9-9. sigslot.py - a simple signals/slots implementation
in Python, following the Observer pattern - 9-10. Object introspection using Qt
- 9-11. Object introspection using Python
- 10-1. event1.py - handling mouse events in PyQt
- 10-2. action.py - Using a QAction to group data associated with
user commands - 10-3. fragment from mdi.py - ten little scribbling windows
- 10-4. event2.py - using QWidget to create a custom,
double-buffered drawing widget. - 10-5. snippet from event3.py - a peach puff drawing
board - 10-6. fragment from action2.py - You cannot create a
QPixmap before a QApplication - 10-7. buttons.py - Four pushbuttons saying
‘hello'. - 10-8. label.py - a label associated with an
edit control - 10-9. radio.py - a group of mutually exclusive
options - 10-10. listbox.py - A listbox where data can be
associated with an entry - 10-11. tree.py - building a tree
- 10-12. layout.py - two box layouts and adding and removing buttons
dynamically to a layout - 10-13. geometry.py - setting the initial size of an
application - 10-14. dialogs.py - opening message and default dialogs boxes
- 10-15. fragment from dialogs.py - opening a file dialog
- 10-16. fragment from dialogs.py - opening a font dialog
- 10-17. fragment from dialogs.py - opening a color dialog
- 10-18. from dv_qt.py - using Qt utility
classes - 10-19. fragment from db_python.py - using Python utility classes
- 10-20. Using QMimeSourceFactory (application.py)
- 10-21. thread1.py — Python threads without
gui - 10-22. Python threads and a PyQt gui window
- 11-1. dlgcomplex.py — a subclass of frmcomplex.py
- 11-2. Setting default values
- 12-1. A simple document-view framework
- 12-2. Scripting an application is easy
- 13-1. Defining a complex toggle action
- 15-1. A testcase for a document manager
- 15-2. The document manager class
- 15-3. The document class
- 15-4. The view class
- 15-5. The application class
- 21-1. typometer.py - A silly type-o-meter that keeps a
running count of how many characters are added to a certain
document and shows a chart of the typerate... - 21-2. charmap.py - a Unicode character selection
widget - 22-1. remote.py - remote control application
- 22-2. view.py - the main view of the remote control
application - 22-3. button.py - the class that implements the pixmapped
buttons - 22-4. A Qt 2 custom style - a minimalist
implementation of the classic Mac style in PyQt. - 22-5. Testing styles
- 23-1. Handling drop events
- 23-2. Drag and drop
- 25-1. Installing the translator
- 26-1. README
- 26-2. setup.py - a sample setup script
- 26-3. MANIFEST.in
- C-1. Interface for
QRegExp::match