1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** Contact: Qt Software Information (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the either Technology Preview License Agreement or the
** Beta Release License Agreement.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain
** additional rights. These rights are described in the Nokia Qt LGPL
** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
** package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
** If you are unsure which license is appropriate for your use, please
** contact the sales department at qt-sales@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
*/
|
