Widgets TutorialIntroductionWidgets are the basic building blocks for graphical user interface (GUI) applications built with Qt. Each GUI component (e.g. buttons, labels, text editor) is a widget that is placed somewhere within a user interface window, or is displayed as an independent window. Each type of widge is provided by a subclass of QWidget, which is itself a subclass of QObject. QWidget is not an abstract class. It can be used as a container for other widgets, and it can be subclassed with minimal effort to create new, custom widgets. QWidget is often used to create a window inside which other QWidgets are placed. As with QObjects, QWidgets can be created with parent objects to indicate ownership, ensuring that objects are deleted when they are no longer used. With widgets, these parent-child relationships have an additional meaning: Each child widget is displayed within the screen area occupied by its parent widget. This means that when you delete a window widget, all the child widgets it contains are also deleted. Writing a main FunctionMany of the GUI examples provided with Qt follow the pattern of having a main.cpp file, which contains the standard code to initialize the application, plus any number of other source/header files that contain the application logic and custom GUI components. A typical main() function in main.cpp looks like this: #include <QtGui> // Include header files for application components. // ... int main(int argc, char *argv[]) { QApplication app(argc, argv); // Set up and show widgets. // ... return app.exec(); } First, a QApplication object is constructed, which can be configured with arguments passed in from the command line. After the widgets have been created and shown, QApplication::exec() is called to start Qt's event loop. Control passes to Qt until this function returns. Finally, main() returns the value returned by QApplication::exec(). Simple widget examplesEach of theses simple widget examples is written entirely within the main() function. Real world widget examplesIn these more advanced examples, the code that creates the widgets and layouts is stored in other files. For example, the GUI for a main window may be created in the constructor of a QMainWindow subclass. Building The ExamplesIf you installed a binary package to get Qt, or if you compiled Qt yourself, the examples described in this tutorial should already be built and ready to run. If you wish to modify and recompile them, follow these steps:
An executable file is created in the current directory. On Windows, this file may be located in a debug or release subdirectory. You can run this executable to see the example code at work. © 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia. Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. |