~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="annotated.html"><font color="#004faf">Annotated</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>

<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Tab Dialog Example</h1>

<p>Files:</p>

<ul>

<li><a href="dialogs-tabdialog-tabdialog-cpp.html">dialogs/tabdialog/tabdialog.cpp</a></li>

<li><a href="dialogs-tabdialog-tabdialog-h.html">dialogs/tabdialog/tabdialog.h</a></li>

<li><a href="dialogs-tabdialog-main-cpp.html">dialogs/tabdialog/main.cpp</a></li>

</ul>

<p>The Tab Dialog example shows how to construct a tab dialog using the <a href="qtabwidget.html">QTabWidget</a> class.</p>

<p>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.</p>

<center><img src="images/tabdialog-example.png" /></center><p>The Tab Dialog example consists of a single <tt>TabDialog</tt> 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.</p>

<h2>TabDialog Class Definition</h2>

<p>The <tt>TabDialog</tt> class is a subclass of <a href="qdialog.html">QDialog</a> that displays a <a href="qtabwidget.html">QTabWidget</a> and two standard dialog buttons. The class definition only contain the class constructor and a private data member for the <a href="qtabwidget.html">QTabWidget</a>:</p>

<pre>  class TabDialog : public QDialog

{

Q_OBJECT

public:

TabDialog(const QString &fileName, QWidget *parent = 0);

private:

QTabWidget *tabWidget;

};</pre>

<p>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.</p>

<h2>TabDialog Class Implementation</h2>

<p>The constructor calls the <a href="qdialog.html">QDialog</a> constructor and creates a <a href="qfileinfo.html">QFileInfo</a> object for the specified filename.</p>

<pre>  TabDialog::TabDialog(const QString &fileName, QWidget *parent)

: QDialog(parent)

{

QFileInfo fileInfo(fileName);

tabWidget = new QTabWidget;

tabWidget->addTab(new GeneralTab(fileInfo), tr("General"));

tabWidget->addTab(new PermissionsTab(fileInfo), tr("Permissions"));

tabWidget->addTab(new ApplicationsTab(fileInfo), tr("Applications"));</pre>

<p>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.</p>

<p>We create two standard push buttons, and connect each of them to the appropriate slots in the dialog:</p>

<pre>  QPushButton *okButton = new QPushButton(tr("OK"));

QPushButton *cancelButton = new QPushButton(tr("Cancel"));

connect(okButton, SIGNAL(clicked()), this, SLOT(accept()));

connect(cancelButton, SIGNAL(clicked()), this, SLOT(reject()));</pre>

<p>We arrange the buttons in a horizontal layout with extra space at the left hand side of the widget then arrange the tab widget above the buttons in the dialog:</p>

<pre>  QHBoxLayout *buttonLayout = new QHBoxLayout;

buttonLayout->addStretch(1);

buttonLayout->addWidget(okButton);

buttonLayout->addWidget(cancelButton);

QVBoxLayout *mainLayout = new QVBoxLayout;

mainLayout->addWidget(tabWidget);

mainLayout->addLayout(buttonLayout);</pre>

<p>Finally, we set the dialog's title:</p>

<pre>  setWindowTitle(tr("Tab Dialog"));

}</pre>

<p>Each of the tabs are subclassed from <a href="qwidget.html">QWidget</a>, and only provide constructors.</p>

<h2>GeneralTab Class Definition</h2>

<p>The GeneralTab widget definition is simple because we are only interested in displaying the contents of a widget within a tab:</p>

<pre>  class GeneralTab : public QWidget

{

Q_OBJECT

public:

GeneralTab(const QFileInfo &fileInfo, QWidget *parent = 0);

};</pre>

<h2>GeneralTab Class Implementation</h2>

<p>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:</p>

<pre>  GeneralTab::GeneralTab(const QFileInfo &fileInfo, QWidget *parent)

: QWidget(parent)

{

QLabel *fileNameLabel = new QLabel(tr("File Name:"));

QLineEdit *fileNameEdit = new QLineEdit(fileInfo.fileName());

QLabel *pathLabel = new QLabel(tr("Path:"));

QLabel *pathValueLabel = new QLabel(fileInfo.absoluteFilePath());

pathValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

QLabel *sizeLabel = new QLabel(tr("Size:"));

100

qlonglong size = fileInfo.size()/1024;

101

QLabel *sizeValueLabel = new QLabel(tr("%1 K").arg(size));

102

sizeValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

103

104

QLabel *lastReadLabel = new QLabel(tr("Last Read:"));

105

QLabel *lastReadValueLabel = new QLabel(fileInfo.lastRead().toString());

106

lastReadValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

107

108

QLabel *lastModLabel = new QLabel(tr("Last Modified:"));

109

QLabel *lastModValueLabel = new QLabel(fileInfo.lastModified().toString());

110

lastModValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

111

112

QVBoxLayout *mainLayout = new QVBoxLayout;

113

mainLayout->addWidget(fileNameLabel);

114

mainLayout->addWidget(fileNameEdit);

115

mainLayout->addWidget(pathLabel);

116

mainLayout->addWidget(pathValueLabel);

117

mainLayout->addWidget(sizeLabel);

118

mainLayout->addWidget(sizeValueLabel);

119

mainLayout->addWidget(lastReadLabel);

120

mainLayout->addWidget(lastReadValueLabel);

121

mainLayout->addWidget(lastModLabel);

122

mainLayout->addWidget(lastModValueLabel);

123

mainLayout->addStretch(1);

124

setLayout(mainLayout);

125

}</pre>

126

127

<h2>PermissionsTab Class Definition</h2>

128

<p>Like the GeneralTab, the PermissionsTab is just used as a placeholder widget for its children:</p>

129

<pre>  class PermissionsTab : public QWidget

130

{

131

Q_OBJECT

132

133

public:

134

PermissionsTab(const QFileInfo &fileInfo, QWidget *parent = 0);

135

};</pre>

136

137

<h2>PermissionsTab Class Implementation</h2>

138

<p>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:</p>

139

<pre>  PermissionsTab::PermissionsTab(const QFileInfo &fileInfo, QWidget *parent)

140

: QWidget(parent)

141

{

142

QGroupBox *permissionsGroup = new QGroupBox(tr("Permissions"));

143

144

QCheckBox *readable = new QCheckBox(tr("Readable"));

145

if (fileInfo.isReadable())

146

readable->setChecked(true);

147

148

QCheckBox *writable = new QCheckBox(tr("Writable"));

149

if ( fileInfo.isWritable() )

150

writable->setChecked(true);

151

152

QCheckBox *executable = new QCheckBox(tr("Executable"));

153

if ( fileInfo.isExecutable() )

154

executable->setChecked(true);

155

156

QGroupBox *ownerGroup = new QGroupBox(tr("Ownership"));

157

158

QLabel *ownerLabel = new QLabel(tr("Owner"));

159

QLabel *ownerValueLabel = new QLabel(fileInfo.owner());

160

ownerValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

161

162

QLabel *groupLabel = new QLabel(tr("Group"));

163

QLabel *groupValueLabel = new QLabel(fileInfo.group());

164

groupValueLabel->setFrameStyle(QFrame::Panel | QFrame::Sunken);

165

166

QVBoxLayout *permissionsLayout = new QVBoxLayout;

167

permissionsLayout->addWidget(readable);

168

permissionsLayout->addWidget(writable);

169

permissionsLayout->addWidget(executable);

170

permissionsGroup->setLayout(permissionsLayout);

171

172

QVBoxLayout *ownerLayout = new QVBoxLayout;

173

ownerLayout->addWidget(ownerLabel);

174

ownerLayout->addWidget(ownerValueLabel);

175

ownerLayout->addWidget(groupLabel);

176

ownerLayout->addWidget(groupValueLabel);

177

ownerGroup->setLayout(ownerLayout);

178

179

QVBoxLayout *mainLayout = new QVBoxLayout;

180

mainLayout->addWidget(permissionsGroup);

181

mainLayout->addWidget(ownerGroup);

182

mainLayout->addStretch(1);

183

setLayout(mainLayout);

184

}</pre>

185

186

<h2>ApplicationsTab Class Definition</h2>

187

<p>The ApplicationsTab is another placeholder widget that is mostly cosmetic:</p>

188

<pre>  class ApplicationsTab : public QWidget

189

{

190

Q_OBJECT

191

192

public:

193

ApplicationsTab(const QFileInfo &fileInfo, QWidget *parent = 0);

194

};</pre>

195

196

<h2>ApplicationsTab Class Implementation</h2>

197

<p>The ApplicationsTab does not show any useful information, but could be used as a template for a more complicated example:</p>

198

<pre>  ApplicationsTab::ApplicationsTab(const QFileInfo &fileInfo, QWidget *parent)

199

: QWidget(parent)

200

{

201

QLabel *topLabel = new QLabel(tr("Open with:"));

202

203

QListWidget *applicationsListBox = new QListWidget;

204

QStringList applications;

205

206

for (int i = 1; i <= 30; ++i)

207

applications.append(tr("Application %1").arg(i));

208

applicationsListBox->insertItems(0, applications);

209

210

QCheckBox *alwaysCheckBox;

211

212

if (fileInfo.suffix().isEmpty())

213

alwaysCheckBox = new QCheckBox(tr("Always use this application to "

214

"open this type of file"));

215

else

216

alwaysCheckBox = new QCheckBox(tr("Always use this application to "

217

"open files with the extension '%1'").arg(fileInfo.suffix()));

218

219

QVBoxLayout *layout = new QVBoxLayout;

220

layout->addWidget(topLabel);

221

layout->addWidget(applicationsListBox);

222

layout->addWidget(alwaysCheckBox);

223

setLayout(layout);

224

}</pre>

225

226

227

228

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

229

230

</tr></table></div></address></body>

231

</html>

Older »