Qt.git - Qt s a cross-platform application framework that is used for developing application software that can be run on various software and hardware platforms with little or no change in the underlying codebase, while still being a native application with native capabilities and speed.

summary refs log tree commit diff stats

path: root/doc/src/snippets/textdocument-blocks

	Commit message (Expand)	Author	Age	Files	Lines
*	Update year in Nokia copyright messages.	Jason McDonald	2012-01-11	5	-5/+5

*	Update copyright year to 2011.	Jason McDonald	2011-01-10	5	-5/+5

*	Doc: Updated example license to three clause BSD license.	David Boddie	2010-06-10	5	-139/+134

*	Update copyright year to 2010	Jason McDonald	2010-01-06	5	-5/+5

*	Update license headers again.	Jason McDonald	2009-09-09	5	-20/+20

*	Merge branch '4.5' into 4.6	Thiago Macieira	2009-08-31	5	-65/+65
\|\
\| *	Update tech preview license header.	Jason McDonald	2009-08-31	5	-65/+65

\| *	Qt's domain name is now qt.nokia.com.	Jason McDonald	2009-08-11	1	-1/+1

\| *	Update license headers.	Jason McDonald	2009-08-11	5	-5/+5

* \|	Update URL's to use new domain.	Jason McDonald	2009-08-12	1	-1/+1

* \|	Update contact URL in license headers.	Jason McDonald	2009-08-12	5	-5/+5
\|/
*	Update license headers as requested by the marketing department.	Jason McDonald	2009-06-16	5	-10/+10

*	Long live Qt 4.5!	Lars Knoll	2009-03-23	6	-0/+429

e described in the Nokia Qt LGPL ** Exception version 1.1, included in the file LGPL_EXCEPTION.txt in this ** package. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** ** ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ /*! \example dialogs/tabdialog \title Tab Dialog Example The Tab Dialog example shows how to construct a tab dialog using the QTabWidget class. Dialogs provide an efficient way for the application to communicate with the user, but complex dialogs suffer from the problem that they often take up too much screen area. By using a number of tabs in a dialog, information can be split into different categories, while remaining accessible. \image tabdialog-example.png The Tab Dialog example consists of a single \c TabDialog class that provides three tabs, each containing information about a particular file, and two standard push buttons that are used to accept or reject the contents of the dialog. \section1 TabDialog Class Definition The \c TabDialog class is a subclass of QDialog that displays a QTabWidget and two standard dialog buttons. The class definition only contain the class constructor and a private data member for the QTabWidget: \snippet examples/dialogs/tabdialog/tabdialog.h 3 In the example, the widget will be used as a top-level window, but we define the constructor so that it can take a parent widget. This allows the dialog to be centered on top of an application's main window. \section1 TabDialog Class Implementation The constructor calls the QDialog constructor and creates a QFileInfo object for the specified filename. \snippet examples/dialogs/tabdialog/tabdialog.cpp 0 The tab widget is populated with three custom widgets that each contain information about the file. We construct each of these without a parent widget because the tab widget will reparent them as they are added to it. We create two standard push buttons, and connect each of them to the appropriate slots in the dialog: \snippet examples/dialogs/tabdialog/tabdialog.cpp 1 \snippet examples/dialogs/tabdialog/tabdialog.cpp 3 We arrange the tab widget above the buttons in the dialog: \snippet examples/dialogs/tabdialog/tabdialog.cpp 4 Finally, we set the dialog's title: \snippet examples/dialogs/tabdialog/tabdialog.cpp 5 Each of the tabs are subclassed from QWidget, and only provide constructors. \section1 GeneralTab Class Definition The GeneralTab widget definition is simple because we are only interested in displaying the contents of a widget within a tab: \snippet examples/dialogs/tabdialog/tabdialog.h 0 \section1 GeneralTab Class Implementation The GeneralTab widget simply displays some information about the file passed by the TabDialog. Various widgets for this purpose, and these are arranged within a vertical layout: \snippet examples/dialogs/tabdialog/tabdialog.cpp 6 \section1 PermissionsTab Class Definition Like the GeneralTab, the PermissionsTab is just used as a placeholder widget for its children: \snippet examples/dialogs/tabdialog/tabdialog.h 1 \section1 PermissionsTab Class Implementation The PermissionsTab shows information about the file's access information, displaying details of the file permissions and owner in widgets that are arranged in nested layouts: \snippet examples/dialogs/tabdialog/tabdialog.cpp 7 \section1 ApplicationsTab Class Definition The ApplicationsTab is another placeholder widget that is mostly cosmetic: \snippet examples/dialogs/tabdialog/tabdialog.h 2 \section1 ApplicationsTab Class Implementation The ApplicationsTab does not show any useful information, but could be used as a template for a more complicated example: \snippet examples/dialogs/tabdialog/tabdialog.cpp 8 */