| 1 | /****************************************************************************
 | 
|---|
| 2 | ** $Id: qtabdialog.cpp 2 2005-11-16 15:49:26Z dmik $
 | 
|---|
| 3 | **
 | 
|---|
| 4 | ** Implementation of QTabDialog class
 | 
|---|
| 5 | **
 | 
|---|
| 6 | ** Created : 960825
 | 
|---|
| 7 | **
 | 
|---|
| 8 | ** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.
 | 
|---|
| 9 | **
 | 
|---|
| 10 | ** This file is part of the dialogs module of the Qt GUI Toolkit.
 | 
|---|
| 11 | **
 | 
|---|
| 12 | ** This file may be distributed under the terms of the Q Public License
 | 
|---|
| 13 | ** as defined by Trolltech AS of Norway and appearing in the file
 | 
|---|
| 14 | ** LICENSE.QPL included in the packaging of this file.
 | 
|---|
| 15 | **
 | 
|---|
| 16 | ** This file may be distributed and/or modified under the terms of the
 | 
|---|
| 17 | ** GNU General Public License version 2 as published by the Free Software
 | 
|---|
| 18 | ** Foundation and appearing in the file LICENSE.GPL included in the
 | 
|---|
| 19 | ** packaging of this file.
 | 
|---|
| 20 | **
 | 
|---|
| 21 | ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
 | 
|---|
| 22 | ** licenses may use this file in accordance with the Qt Commercial License
 | 
|---|
| 23 | ** Agreement provided with the Software.
 | 
|---|
| 24 | **
 | 
|---|
| 25 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 | 
|---|
| 26 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 | 
|---|
| 27 | **
 | 
|---|
| 28 | ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
 | 
|---|
| 29 | **   information about Qt Commercial License Agreements.
 | 
|---|
| 30 | ** See http://www.trolltech.com/qpl/ for QPL licensing information.
 | 
|---|
| 31 | ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 | 
|---|
| 32 | **
 | 
|---|
| 33 | ** Contact info@trolltech.com if any conditions of this licensing are
 | 
|---|
| 34 | ** not clear to you.
 | 
|---|
| 35 | **
 | 
|---|
| 36 | **********************************************************************/
 | 
|---|
| 37 | 
 | 
|---|
| 38 | #include "qtabdialog.h"
 | 
|---|
| 39 | 
 | 
|---|
| 40 | #ifndef QT_NO_TABDIALOG
 | 
|---|
| 41 | 
 | 
|---|
| 42 | #include "qobjectlist.h"
 | 
|---|
| 43 | #include "qtabbar.h"
 | 
|---|
| 44 | #include "qtabwidget.h"
 | 
|---|
| 45 | #include "qpushbutton.h"
 | 
|---|
| 46 | #include "qpainter.h"
 | 
|---|
| 47 | #include "qpixmap.h"
 | 
|---|
| 48 | #include "qapplication.h"
 | 
|---|
| 49 | #include "qtabwidget.h"
 | 
|---|
| 50 | #include "qwidgetstack.h"
 | 
|---|
| 51 | #include "qlayout.h"
 | 
|---|
| 52 | 
 | 
|---|
| 53 | /*!
 | 
|---|
| 54 |   \class QTabDialog qtabdialog.h
 | 
|---|
| 55 | 
 | 
|---|
| 56 |   \brief The QTabDialog class provides a stack of tabbed widgets.
 | 
|---|
| 57 | 
 | 
|---|
| 58 |   \ingroup dialogs
 | 
|---|
| 59 |   \mainclass
 | 
|---|
| 60 | 
 | 
|---|
| 61 |   A tabbed dialog is one in which several "tab pages" are available.
 | 
|---|
| 62 |   By clicking on a tab page's tab or by pressing the indicated
 | 
|---|
| 63 |   Alt+\e{letter} key combination, the user can select which tab page
 | 
|---|
| 64 |   they want to use.
 | 
|---|
| 65 | 
 | 
|---|
| 66 |   QTabDialog provides a tab bar consisting of single row of tabs at
 | 
|---|
| 67 |   the top; each tab has an associated widget which is that tab's
 | 
|---|
| 68 |   tab page. In addition, QTabDialog provides an OK button and the
 | 
|---|
| 69 |   following optional buttons: Apply, Cancel, Defaults and Help.
 | 
|---|
| 70 | 
 | 
|---|
| 71 |   The normal way to use QTabDialog is to do the following in the
 | 
|---|
| 72 |   constructor:
 | 
|---|
| 73 |   \list 1
 | 
|---|
| 74 |   \i Create a QTabDialog.
 | 
|---|
| 75 |   \i Create a QWidget for each of the pages in the tab dialog, insert
 | 
|---|
| 76 |   children into it, set up geometry management for it, and use
 | 
|---|
| 77 |   addTab() (or insertTab()) to set up a tab and keyboard accelerator
 | 
|---|
| 78 |   for it.
 | 
|---|
| 79 |   \i Set up the buttons for the tab dialog using setOkButton(),
 | 
|---|
| 80 |   setApplyButton(), setDefaultsButton(), setCancelButton() and
 | 
|---|
| 81 |   setHelpButton().
 | 
|---|
| 82 |   \i Connect to the signals and slots.
 | 
|---|
| 83 |   \endlist
 | 
|---|
| 84 | 
 | 
|---|
| 85 |   If you don't call addTab() the page you have created will not be
 | 
|---|
| 86 |   visible. Don't confuse the object name you supply to the
 | 
|---|
| 87 |   QWidget constructor and the tab label you supply to addTab();
 | 
|---|
| 88 |   addTab() takes user-visible name that appears on the widget's tab
 | 
|---|
| 89 |   and may identify an accelerator, whereas the widget name is used
 | 
|---|
| 90 |   primarily for debugging.
 | 
|---|
| 91 | 
 | 
|---|
| 92 |   Almost all applications have to connect the applyButtonPressed()
 | 
|---|
| 93 |   signal to something. applyButtonPressed() is emitted when either OK
 | 
|---|
| 94 |   or Apply is clicked, and your slot must copy the dialog's state into
 | 
|---|
| 95 |   the application.
 | 
|---|
| 96 | 
 | 
|---|
| 97 |   There are also several other signals which may be useful:
 | 
|---|
| 98 |   \list
 | 
|---|
| 99 |   \i cancelButtonPressed() is emitted when the user clicks Cancel.
 | 
|---|
| 100 |   \i defaultButtonPressed() is emitted when the user clicks Defaults;
 | 
|---|
| 101 |   the slot it is connected to should reset the state of the dialog to
 | 
|---|
| 102 |   the application defaults.
 | 
|---|
| 103 |   \i helpButtonPressed() is emitted when the user clicks Help.
 | 
|---|
| 104 |   \i aboutToShow() is emitted at the start of show(); if there is any
 | 
|---|
| 105 |   chance that the state of the application may change between the
 | 
|---|
| 106 |   creation of the tab dialog and the time show() is called, you must
 | 
|---|
| 107 |   connect this signal to a slot that resets the state of the dialog.
 | 
|---|
| 108 |   \i currentChanged() is emitted when the user selects a page.
 | 
|---|
| 109 |   \endlist
 | 
|---|
| 110 | 
 | 
|---|
| 111 |   Each tab is either enabled or disabled at any given time (see
 | 
|---|
| 112 |   setTabEnabled()). If a tab is enabled the tab text is drawn in
 | 
|---|
| 113 |   black and the user can select that tab. If it is disabled the tab
 | 
|---|
| 114 |   is drawn in a different way and the user cannot select that tab.
 | 
|---|
| 115 |   Note that even if a tab is disabled, the page can still be visible;
 | 
|---|
| 116 |   for example, if all of the tabs happen to be disabled.
 | 
|---|
| 117 | 
 | 
|---|
| 118 |   You can change a tab's label and iconset using changeTab(). A tab
 | 
|---|
| 119 |   page can be removed with removePage() and shown with showPage(). The
 | 
|---|
| 120 |   current page is given by currentPage().
 | 
|---|
| 121 | 
 | 
|---|
| 122 |   QTabDialog does not support tabs on the sides or bottom, nor can
 | 
|---|
| 123 |   you set or retrieve the visible page. If you need more functionality
 | 
|---|
| 124 |   than QTabDialog provides, consider creating a QDialog and using a
 | 
|---|
| 125 |   QTabBar with QTabWidgets.
 | 
|---|
| 126 | 
 | 
|---|
| 127 |   Most of the functionality in QTabDialog is provided by a QTabWidget.
 | 
|---|
| 128 | 
 | 
|---|
| 129 |   <img src=qtabdlg-m.png> <img src=qtabdlg-w.png>
 | 
|---|
| 130 | 
 | 
|---|
| 131 |   \sa QDialog
 | 
|---|
| 132 | */
 | 
|---|
| 133 | 
 | 
|---|
| 134 | /*!
 | 
|---|
| 135 |   \fn void QTabDialog::selected( const QString & );
 | 
|---|
| 136 |   \obsolete
 | 
|---|
| 137 | 
 | 
|---|
| 138 |   This signal is emitted whenever a tab is selected (raised),
 | 
|---|
| 139 |   including during the first show().
 | 
|---|
| 140 | 
 | 
|---|
| 141 |   \sa raise()
 | 
|---|
| 142 | */
 | 
|---|
| 143 | 
 | 
|---|
| 144 | /*! \fn void QTabDialog::currentChanged( QWidget* );
 | 
|---|
| 145 | 
 | 
|---|
| 146 |   This signal is emitted whenever the current page changes.
 | 
|---|
| 147 | 
 | 
|---|
| 148 |   \sa currentPage(), showPage(), tabLabel()
 | 
|---|
| 149 | */
 | 
|---|
| 150 | 
 | 
|---|
| 151 | 
 | 
|---|
| 152 | // add comments about delete, ok and apply
 | 
|---|
| 153 | 
 | 
|---|
| 154 | class QTabDialogPrivate
 | 
|---|
| 155 | {
 | 
|---|
| 156 | public:
 | 
|---|
| 157 |     QTabDialogPrivate();
 | 
|---|
| 158 | 
 | 
|---|
| 159 |     QTabWidget* tw;
 | 
|---|
| 160 | 
 | 
|---|
| 161 |     QPushButton * ok;
 | 
|---|
| 162 |     QPushButton * cb;
 | 
|---|
| 163 |     QPushButton * db;
 | 
|---|
| 164 |     QPushButton * hb;
 | 
|---|
| 165 |     QPushButton * ab;
 | 
|---|
| 166 | 
 | 
|---|
| 167 |     QBoxLayout * tll;
 | 
|---|
| 168 | };
 | 
|---|
| 169 | 
 | 
|---|
| 170 | QTabDialogPrivate::QTabDialogPrivate()
 | 
|---|
| 171 |         : tw(0),
 | 
|---|
| 172 |           ok(0), cb(0), db(0), hb(0), ab(0),
 | 
|---|
| 173 |           tll(0)
 | 
|---|
| 174 | { }
 | 
|---|
| 175 | 
 | 
|---|
| 176 | /*!
 | 
|---|
| 177 |   Constructs a QTabDialog with only an OK button.
 | 
|---|
| 178 |   The \a parent, \a name, \a modal and widget flag, \a f, arguments
 | 
|---|
| 179 |   are passed on to the QDialog constructor.
 | 
|---|
| 180 | */
 | 
|---|
| 181 | 
 | 
|---|
| 182 | QTabDialog::QTabDialog( QWidget *parent, const char *name, bool modal,
 | 
|---|
| 183 |                         WFlags f )
 | 
|---|
| 184 |     : QDialog( parent, name, modal, f )
 | 
|---|
| 185 | {
 | 
|---|
| 186 |     d = new QTabDialogPrivate;
 | 
|---|
| 187 |     Q_CHECK_PTR( d );
 | 
|---|
| 188 | 
 | 
|---|
| 189 |     d->tw = new QTabWidget( this, "tab widget" );
 | 
|---|
| 190 |     connect ( d->tw, SIGNAL ( selected(const QString&) ), this, SIGNAL( selected(const QString&) ) );
 | 
|---|
| 191 |     connect ( d->tw, SIGNAL ( currentChanged(QWidget*) ), this, SIGNAL( currentChanged(QWidget*) ) );
 | 
|---|
| 192 | 
 | 
|---|
| 193 |     d->ok = new QPushButton( this, "ok" );
 | 
|---|
| 194 |     Q_CHECK_PTR( d->ok );
 | 
|---|
| 195 |     d->ok->setText( tr("OK") );
 | 
|---|
| 196 |     d->ok->setDefault( TRUE );
 | 
|---|
| 197 |     connect( d->ok, SIGNAL(clicked()),
 | 
|---|
| 198 |              this, SIGNAL(applyButtonPressed()) );
 | 
|---|
| 199 |     connect( d->ok, SIGNAL(clicked()),
 | 
|---|
| 200 |              this, SLOT(accept()) );
 | 
|---|
| 201 | }
 | 
|---|
| 202 | 
 | 
|---|
| 203 | 
 | 
|---|
| 204 | /*!
 | 
|---|
| 205 |   Destroys the tab dialog.
 | 
|---|
| 206 | */
 | 
|---|
| 207 | 
 | 
|---|
| 208 | QTabDialog::~QTabDialog()
 | 
|---|
| 209 | {
 | 
|---|
| 210 |     delete d;
 | 
|---|
| 211 | }
 | 
|---|
| 212 | 
 | 
|---|
| 213 | 
 | 
|---|
| 214 | /*!
 | 
|---|
| 215 |   Sets the font for the tabs to \a font.
 | 
|---|
| 216 | 
 | 
|---|
| 217 |   If the widget is visible, the display is updated with the new font
 | 
|---|
| 218 |   immediately. There may be some geometry changes, depending on the
 | 
|---|
| 219 |   size of the old and new fonts.
 | 
|---|
| 220 | */
 | 
|---|
| 221 | 
 | 
|---|
| 222 | void QTabDialog::setFont( const QFont & font )
 | 
|---|
| 223 | {
 | 
|---|
| 224 |     QDialog::setFont( font );
 | 
|---|
| 225 |     setSizes();
 | 
|---|
| 226 | }
 | 
|---|
| 227 | 
 | 
|---|
| 228 | 
 | 
|---|
| 229 | /*!
 | 
|---|
| 230 |   \fn void QTabDialog::applyButtonPressed();
 | 
|---|
| 231 | 
 | 
|---|
| 232 |   This signal is emitted when either the Apply or OK button is clicked.
 | 
|---|
| 233 | 
 | 
|---|
| 234 |   It should be connected to a slot (or several slots) that change the
 | 
|---|
| 235 |   application's state according to the state of the dialog.
 | 
|---|
| 236 | 
 | 
|---|
| 237 |   \sa cancelButtonPressed() defaultButtonPressed() setApplyButton()
 | 
|---|
| 238 | */
 | 
|---|
| 239 | 
 | 
|---|
| 240 | 
 | 
|---|
| 241 | /*!
 | 
|---|
| 242 |   Returns TRUE if the tab dialog has a Defaults button; otherwise
 | 
|---|
| 243 |   returns FALSE.
 | 
|---|
| 244 | 
 | 
|---|
| 245 |   \sa setDefaultButton() defaultButtonPressed() hasApplyButton()
 | 
|---|
| 246 |   hasCancelButton()
 | 
|---|
| 247 | */
 | 
|---|
| 248 | 
 | 
|---|
| 249 | bool QTabDialog::hasDefaultButton() const
 | 
|---|
| 250 | {
 | 
|---|
| 251 |      return d->db != 0;
 | 
|---|
| 252 | }
 | 
|---|
| 253 | 
 | 
|---|
| 254 | 
 | 
|---|
| 255 | /*!
 | 
|---|
| 256 |   Returns TRUE if the tab dialog has a Help button; otherwise returns
 | 
|---|
| 257 |   FALSE.
 | 
|---|
| 258 | 
 | 
|---|
| 259 |   \sa setHelpButton() helpButtonPressed() hasApplyButton()
 | 
|---|
| 260 |   hasCancelButton()
 | 
|---|
| 261 | */
 | 
|---|
| 262 | 
 | 
|---|
| 263 | bool QTabDialog::hasHelpButton() const
 | 
|---|
| 264 | {
 | 
|---|
| 265 |      return d->hb != 0;
 | 
|---|
| 266 | }
 | 
|---|
| 267 | 
 | 
|---|
| 268 | 
 | 
|---|
| 269 | /*!
 | 
|---|
| 270 |   \fn void QTabDialog::cancelButtonPressed();
 | 
|---|
| 271 | 
 | 
|---|
| 272 |   This signal is emitted when the Cancel button is clicked. It is
 | 
|---|
| 273 |   automatically connected to QDialog::reject(), which will hide the
 | 
|---|
| 274 |   dialog.
 | 
|---|
| 275 | 
 | 
|---|
| 276 |   The Cancel button should not change the application's state at all,
 | 
|---|
| 277 |   so you should generally not need to connect it to any slot.
 | 
|---|
| 278 | 
 | 
|---|
| 279 |   \sa applyButtonPressed() defaultButtonPressed() setCancelButton()
 | 
|---|
| 280 | */
 | 
|---|
| 281 | 
 | 
|---|
| 282 | 
 | 
|---|
| 283 | /*!
 | 
|---|
| 284 |   Returns TRUE if the tab dialog has a Cancel button; otherwise
 | 
|---|
| 285 |   returns FALSE.
 | 
|---|
| 286 | 
 | 
|---|
| 287 |   \sa setCancelButton() cancelButtonPressed() hasApplyButton()
 | 
|---|
| 288 |   hasDefaultButton()
 | 
|---|
| 289 | */
 | 
|---|
| 290 | 
 | 
|---|
| 291 | bool QTabDialog::hasCancelButton() const
 | 
|---|
| 292 | {
 | 
|---|
| 293 |      return d->cb != 0;
 | 
|---|
| 294 | }
 | 
|---|
| 295 | 
 | 
|---|
| 296 | 
 | 
|---|
| 297 | /*!
 | 
|---|
| 298 |   \fn void QTabDialog::defaultButtonPressed();
 | 
|---|
| 299 | 
 | 
|---|
| 300 |   This signal is emitted when the Defaults button is pressed. It
 | 
|---|
| 301 |   should reset the dialog (but not the application) to the "factory
 | 
|---|
| 302 |   defaults".
 | 
|---|
| 303 | 
 | 
|---|
| 304 |   The application's state should not be changed until the user clicks
 | 
|---|
| 305 |   Apply or OK.
 | 
|---|
| 306 | 
 | 
|---|
| 307 |   \sa applyButtonPressed() cancelButtonPressed() setDefaultButton()
 | 
|---|
| 308 | */
 | 
|---|
| 309 | 
 | 
|---|
| 310 | 
 | 
|---|
| 311 | /*!
 | 
|---|
| 312 |   \fn void QTabDialog::helpButtonPressed();
 | 
|---|
| 313 | 
 | 
|---|
| 314 |   This signal is emitted when the Help button is pressed. It
 | 
|---|
| 315 |   could be used to present information about how to use the dialog.
 | 
|---|
| 316 | 
 | 
|---|
| 317 |   \sa applyButtonPressed() cancelButtonPressed() setHelpButton()
 | 
|---|
| 318 | */
 | 
|---|
| 319 | 
 | 
|---|
| 320 | 
 | 
|---|
| 321 | /*!
 | 
|---|
| 322 |   Returns TRUE if the tab dialog has an Apply button; otherwise
 | 
|---|
| 323 |   returns FALSE.
 | 
|---|
| 324 | 
 | 
|---|
| 325 |   \sa setApplyButton() applyButtonPressed() hasCancelButton()
 | 
|---|
| 326 |   hasDefaultButton()
 | 
|---|
| 327 | */
 | 
|---|
| 328 | 
 | 
|---|
| 329 | bool QTabDialog::hasApplyButton() const
 | 
|---|
| 330 | {
 | 
|---|
| 331 |     return d->ab != 0;
 | 
|---|
| 332 | }
 | 
|---|
| 333 | 
 | 
|---|
| 334 | 
 | 
|---|
| 335 | /*!
 | 
|---|
| 336 |   Returns TRUE if the tab dialog has an OK button; otherwise returns
 | 
|---|
| 337 |   FALSE.
 | 
|---|
| 338 | 
 | 
|---|
| 339 |   \sa setOkButton() hasApplyButton() hasCancelButton()
 | 
|---|
| 340 |   hasDefaultButton()
 | 
|---|
| 341 | */
 | 
|---|
| 342 | 
 | 
|---|
| 343 | bool QTabDialog::hasOkButton() const
 | 
|---|
| 344 | {
 | 
|---|
| 345 |     return d->ok != 0;
 | 
|---|
| 346 | }
 | 
|---|
| 347 | 
 | 
|---|
| 348 | 
 | 
|---|
| 349 | /*!
 | 
|---|
| 350 |   \fn void QTabDialog::aboutToShow()
 | 
|---|
| 351 | 
 | 
|---|
| 352 |   This signal is emitted by show() when it is time to set the state of
 | 
|---|
| 353 |   the dialog's contents. The dialog should reflect the current state
 | 
|---|
| 354 |   of the application when it appears; if there is any possibility that
 | 
|---|
| 355 |   the state of the application may change between the time you call
 | 
|---|
| 356 |   QTabDialog::QTabDialog() and QTabDialog::show(), you should set the
 | 
|---|
| 357 |   dialog's state in a slot and connect this signal to it.
 | 
|---|
| 358 | 
 | 
|---|
| 359 |   This applies mainly to QTabDialog objects that are kept around
 | 
|---|
| 360 |   hidden, rather than being created, shown, and deleted afterwards.
 | 
|---|
| 361 | 
 | 
|---|
| 362 |   \sa applyButtonPressed(), show(), cancelButtonPressed()
 | 
|---|
| 363 | */
 | 
|---|
| 364 | 
 | 
|---|
| 365 | 
 | 
|---|
| 366 | /*!\reimp
 | 
|---|
| 367 | */
 | 
|---|
| 368 | void QTabDialog::show()
 | 
|---|
| 369 | {
 | 
|---|
| 370 |     //   Reimplemented in order to delay show()'ing of every page
 | 
|---|
| 371 |     //   except the initially visible one, and in order to emit the
 | 
|---|
| 372 |     //   aboutToShow() signal.
 | 
|---|
| 373 |     if ( topLevelWidget() == this )
 | 
|---|
| 374 |         d->tw->setFocus();
 | 
|---|
| 375 |     emit aboutToShow();
 | 
|---|
| 376 |     setSizes();
 | 
|---|
| 377 |     setUpLayout();
 | 
|---|
| 378 |     QDialog::show();
 | 
|---|
| 379 | }
 | 
|---|
| 380 | 
 | 
|---|
| 381 | 
 | 
|---|
| 382 | /*!
 | 
|---|
| 383 |   Ensures that tab page \a i is visible and appropriately sized.
 | 
|---|
| 384 | */
 | 
|---|
| 385 | 
 | 
|---|
| 386 | void QTabDialog::showTab( int i )
 | 
|---|
| 387 | {
 | 
|---|
| 388 |     d->tw->showTab( i );
 | 
|---|
| 389 | }
 | 
|---|
| 390 | 
 | 
|---|
| 391 | 
 | 
|---|
| 392 | /*!
 | 
|---|
| 393 |   Adds another tab and page to the tab view.
 | 
|---|
| 394 | 
 | 
|---|
| 395 |   The new page is \a child; the tab's label is \a label.
 | 
|---|
| 396 |   Note the difference between the widget name (which you supply to
 | 
|---|
| 397 |   widget constructors and to setTabEnabled(), for example) and the tab
 | 
|---|
| 398 |   label. The name is internal to the program and invariant, whereas
 | 
|---|
| 399 |   the label is shown on-screen and may vary according to language and
 | 
|---|
| 400 |   other factors.
 | 
|---|
| 401 | 
 | 
|---|
| 402 |   If the tab's \a label contains an ampersand, the letter following
 | 
|---|
| 403 |   the ampersand is used as an accelerator for the tab, e.g. if the
 | 
|---|
| 404 |   label is "Bro&wse" then Alt+W becomes an accelerator which will
 | 
|---|
| 405 |   move the focus to this tab.
 | 
|---|
| 406 | 
 | 
|---|
| 407 |   If you call addTab() after show() the screen will flicker and the
 | 
|---|
| 408 |   user may be confused.
 | 
|---|
| 409 | 
 | 
|---|
| 410 |   \sa insertTab()
 | 
|---|
| 411 | */
 | 
|---|
| 412 | 
 | 
|---|
| 413 | void QTabDialog::addTab( QWidget * child, const QString &label )
 | 
|---|
| 414 | {
 | 
|---|
| 415 |     d->tw->addTab( child, label );
 | 
|---|
| 416 | }
 | 
|---|
| 417 | 
 | 
|---|
| 418 | 
 | 
|---|
| 419 | 
 | 
|---|
| 420 | /*! \overload
 | 
|---|
| 421 | 
 | 
|---|
| 422 |   This version of the function shows the \a iconset as well as the \a
 | 
|---|
| 423 |   label on the tab of \a child.
 | 
|---|
| 424 | */
 | 
|---|
| 425 | void QTabDialog::addTab( QWidget *child, const QIconSet& iconset, const QString &label)
 | 
|---|
| 426 | {
 | 
|---|
| 427 |     d->tw->addTab( child, iconset, label );
 | 
|---|
| 428 | }
 | 
|---|
| 429 | 
 | 
|---|
| 430 | /*!
 | 
|---|
| 431 |   \overload
 | 
|---|
| 432 | 
 | 
|---|
| 433 |   This is a lower-level method for adding tabs, similar to the other
 | 
|---|
| 434 |   addTab() method. It is useful if you are using setTabBar() to set a
 | 
|---|
| 435 |   QTabBar subclass with an overridden QTabBar::paint() function for a
 | 
|---|
| 436 |   subclass of QTab.
 | 
|---|
| 437 | 
 | 
|---|
| 438 |   The \a child is the widget to be placed on the new tab page. The \a
 | 
|---|
| 439 |   tab is the tab to display on the tab page -- normally this shows a
 | 
|---|
| 440 |   label or an icon that identifies the tab page.
 | 
|---|
| 441 | 
 | 
|---|
| 442 | */
 | 
|---|
| 443 | void QTabDialog::addTab( QWidget * child, QTab* tab )
 | 
|---|
| 444 | {
 | 
|---|
| 445 |     d->tw->addTab( child, tab );
 | 
|---|
| 446 | }
 | 
|---|
| 447 | 
 | 
|---|
| 448 | /*!
 | 
|---|
| 449 |   Inserts another tab and page to the tab view.
 | 
|---|
| 450 | 
 | 
|---|
| 451 |   The new page is \a child; the tab's label is \a label.
 | 
|---|
| 452 |   Note the difference between the widget name (which you supply to
 | 
|---|
| 453 |   widget constructors and to setTabEnabled(), for example) and the tab
 | 
|---|
| 454 |   label. The name is internal to the program and invariant, whereas
 | 
|---|
| 455 |   the label is shown on-screen and may vary according to language and
 | 
|---|
| 456 |   other factors.
 | 
|---|
| 457 | 
 | 
|---|
| 458 |   If the tab's \a label contains an ampersand, the letter following
 | 
|---|
| 459 |   the ampersand is used as an accelerator for the tab, e.g. if the
 | 
|---|
| 460 |   label is "Bro&wse" then Alt+W becomes an accelerator which will
 | 
|---|
| 461 |   move the focus to this tab.
 | 
|---|
| 462 | 
 | 
|---|
| 463 |   If \a index is not specified, the tab is simply added. Otherwise
 | 
|---|
| 464 |   it is inserted at the specified position.
 | 
|---|
| 465 | 
 | 
|---|
| 466 |   If you call insertTab() after show(), the screen will flicker and the
 | 
|---|
| 467 |   user may be confused.
 | 
|---|
| 468 | 
 | 
|---|
| 469 |   \sa addTab()
 | 
|---|
| 470 | */
 | 
|---|
| 471 | 
 | 
|---|
| 472 | void QTabDialog::insertTab( QWidget * child, const QString &label, int index )
 | 
|---|
| 473 | {
 | 
|---|
| 474 |     d->tw->insertTab( child, label, index );
 | 
|---|
| 475 | }
 | 
|---|
| 476 | 
 | 
|---|
| 477 | 
 | 
|---|
| 478 | /*! \overload
 | 
|---|
| 479 | 
 | 
|---|
| 480 |   This version of the function shows the \a iconset as well as the \a
 | 
|---|
| 481 |   label on the tab of \a child.
 | 
|---|
| 482 |  */
 | 
|---|
| 483 | void QTabDialog::insertTab( QWidget *child, const QIconSet& iconset, const QString &label, int index)
 | 
|---|
| 484 | {
 | 
|---|
| 485 |     d->tw->insertTab( child, iconset, label, index );
 | 
|---|
| 486 | }
 | 
|---|
| 487 | 
 | 
|---|
| 488 | /*!
 | 
|---|
| 489 |     \overload
 | 
|---|
| 490 | 
 | 
|---|
| 491 |   This is a lower-level method for inserting tabs, similar to the other
 | 
|---|
| 492 |   insertTab() method. It is useful if you are using setTabBar() to set a
 | 
|---|
| 493 |   QTabBar subclass with an overridden QTabBar::paint() function for a
 | 
|---|
| 494 |   subclass of QTab.
 | 
|---|
| 495 | 
 | 
|---|
| 496 |   The \a child is the widget to be placed on the new tab page. The \a
 | 
|---|
| 497 |   tab is the tab to display on the tab page -- normally this shows a
 | 
|---|
| 498 |   label or an icon that identifies the tab page. The \a index is the
 | 
|---|
| 499 |   position where this tab page should be inserted.
 | 
|---|
| 500 | 
 | 
|---|
| 501 | */
 | 
|---|
| 502 | void QTabDialog::insertTab( QWidget * child, QTab* tab, int index )
 | 
|---|
| 503 | {
 | 
|---|
| 504 |     d->tw->insertTab( child, tab, index );
 | 
|---|
| 505 | }
 | 
|---|
| 506 | 
 | 
|---|
| 507 | /*!
 | 
|---|
| 508 |   Replaces the QTabBar heading the dialog by the given tab bar, \a tb.
 | 
|---|
| 509 |   Note that this must be called \e before any tabs have been added,
 | 
|---|
| 510 |   or the behavior is undefined.
 | 
|---|
| 511 |   \sa tabBar()
 | 
|---|
| 512 | */
 | 
|---|
| 513 | void QTabDialog::setTabBar( QTabBar* tb )
 | 
|---|
| 514 | {
 | 
|---|
| 515 |     d->tw->setTabBar( tb );
 | 
|---|
| 516 |     setUpLayout();
 | 
|---|
| 517 | }
 | 
|---|
| 518 | 
 | 
|---|
| 519 | /*!
 | 
|---|
| 520 |   Returns the currently set QTabBar.
 | 
|---|
| 521 |   \sa setTabBar()
 | 
|---|
| 522 | */
 | 
|---|
| 523 | QTabBar* QTabDialog::tabBar() const
 | 
|---|
| 524 | {
 | 
|---|
| 525 |     return d->tw->tabBar();
 | 
|---|
| 526 | }
 | 
|---|
| 527 | 
 | 
|---|
| 528 | /*!  Ensures that widget \a w is shown. This is mainly useful for accelerators.
 | 
|---|
| 529 | 
 | 
|---|
| 530 |   \warning If used carelessly, this function can easily surprise or
 | 
|---|
| 531 |   confuse the user.
 | 
|---|
| 532 | 
 | 
|---|
| 533 |   \sa QTabBar::setCurrentTab()
 | 
|---|
| 534 | */
 | 
|---|
| 535 | 
 | 
|---|
| 536 | void QTabDialog::showPage( QWidget * w )
 | 
|---|
| 537 | {
 | 
|---|
| 538 |     d->tw->showPage( w );
 | 
|---|
| 539 | }
 | 
|---|
| 540 | 
 | 
|---|
| 541 | 
 | 
|---|
| 542 | /*! \obsolete
 | 
|---|
| 543 |   Returns TRUE if the page with object name \a name is enabled and
 | 
|---|
| 544 |   FALSE if it is disabled.
 | 
|---|
| 545 | 
 | 
|---|
| 546 |   If \a name is 0 or not the name of any of the pages, isTabEnabled()
 | 
|---|
| 547 |   returns FALSE.
 | 
|---|
| 548 | 
 | 
|---|
| 549 |   \sa setTabEnabled(), QWidget::isEnabled()
 | 
|---|
| 550 | */
 | 
|---|
| 551 | 
 | 
|---|
| 552 | bool QTabDialog::isTabEnabled( const char* name ) const
 | 
|---|
| 553 | {
 | 
|---|
| 554 |     if ( !name )
 | 
|---|
| 555 |         return FALSE;
 | 
|---|
| 556 |     QObjectList * l
 | 
|---|
| 557 |         = ((QTabDialog *)this)->queryList( "QWidget", name, FALSE, TRUE );
 | 
|---|
| 558 |     if ( l && l->first() ) {
 | 
|---|
| 559 |         QWidget * w;
 | 
|---|
| 560 |         while( l->current() ) {
 | 
|---|
| 561 |             while( l->current() && !l->current()->isWidgetType() )
 | 
|---|
| 562 |                 l->next();
 | 
|---|
| 563 |             w = (QWidget *)(l->current());
 | 
|---|
| 564 |             if ( w ) {
 | 
|---|
| 565 |                 bool enabled = d->tw->isTabEnabled( w );
 | 
|---|
| 566 |                 delete l;
 | 
|---|
| 567 |                 return enabled;
 | 
|---|
| 568 |             }
 | 
|---|
| 569 |         }
 | 
|---|
| 570 |     }
 | 
|---|
| 571 |     delete l;
 | 
|---|
| 572 |     return FALSE;
 | 
|---|
| 573 | }
 | 
|---|
| 574 | 
 | 
|---|
| 575 | 
 | 
|---|
| 576 | /*!\obsolete
 | 
|---|
| 577 | 
 | 
|---|
| 578 |   Finds the page with object name \a name, enables/disables it
 | 
|---|
| 579 |   according to the value of \a enable and redraws the page's tab
 | 
|---|
| 580 |   appropriately.
 | 
|---|
| 581 | 
 | 
|---|
| 582 |   QTabDialog uses QWidget::setEnabled() internally, rather than keeping a
 | 
|---|
| 583 |   separate flag.
 | 
|---|
| 584 | 
 | 
|---|
| 585 |   Note that even a disabled tab/page may be visible. If the page is
 | 
|---|
| 586 |   already visible QTabDialog will not hide it; if all the pages
 | 
|---|
| 587 |   are disabled QTabDialog will show one of them.
 | 
|---|
| 588 | 
 | 
|---|
| 589 |   The object name is used (rather than the tab label) because the tab
 | 
|---|
| 590 |   text may not be invariant in multi-language applications.
 | 
|---|
| 591 | 
 | 
|---|
| 592 |   \sa isTabEnabled(), QWidget::setEnabled()
 | 
|---|
| 593 | */
 | 
|---|
| 594 | 
 | 
|---|
| 595 | void QTabDialog::setTabEnabled( const char* name, bool enable )
 | 
|---|
| 596 | {
 | 
|---|
| 597 |     if ( !name )
 | 
|---|
| 598 |         return;
 | 
|---|
| 599 |     QObjectList * l
 | 
|---|
| 600 |         = ((QTabDialog *)this)->queryList( "QWidget", name, FALSE, TRUE );
 | 
|---|
| 601 |     if ( l && l->first() ) {
 | 
|---|
| 602 |         QObjectListIt it(*l);
 | 
|---|
| 603 |         QObject *o;
 | 
|---|
| 604 |         while( (o = it.current()) ) {
 | 
|---|
| 605 |             ++it;
 | 
|---|
| 606 |             if( o->isWidgetType() )
 | 
|---|
| 607 |                 d->tw->setTabEnabled( (QWidget*)o, enable );
 | 
|---|
| 608 |         }
 | 
|---|
| 609 |     }
 | 
|---|
| 610 |     delete l;
 | 
|---|
| 611 | }
 | 
|---|
| 612 | 
 | 
|---|
| 613 | 
 | 
|---|
| 614 | /* ### SHOULD THIS BE HERE?
 | 
|---|
| 615 |   Adds an Apply button to the dialog. The button's text is set to \e
 | 
|---|
| 616 |   text (and defaults to "Apply").
 | 
|---|
| 617 | 
 | 
|---|
| 618 |   The Apply button should apply the current settings in the dialog box
 | 
|---|
| 619 |   to the application, while keeping the dialog visible.
 | 
|---|
| 620 | 
 | 
|---|
| 621 |   When Apply is clicked, the applyButtonPressed() signal is emitted.
 | 
|---|
| 622 | 
 | 
|---|
| 623 |   If \a text is a
 | 
|---|
| 624 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 625 |   no button is shown.
 | 
|---|
| 626 | 
 | 
|---|
| 627 |   \sa setCancelButton() setDefaultButton() applyButtonPressed()
 | 
|---|
| 628 | */
 | 
|---|
| 629 | 
 | 
|---|
| 630 | 
 | 
|---|
| 631 | /*!
 | 
|---|
| 632 |   Returns TRUE if the page \a w is enabled; otherwise returns FALSE.
 | 
|---|
| 633 | 
 | 
|---|
| 634 |   \sa setTabEnabled(), QWidget::isEnabled()
 | 
|---|
| 635 | */
 | 
|---|
| 636 | 
 | 
|---|
| 637 | bool QTabDialog::isTabEnabled( QWidget* w ) const
 | 
|---|
| 638 | {
 | 
|---|
| 639 |     return d->tw->isTabEnabled( w );
 | 
|---|
| 640 | }
 | 
|---|
| 641 | 
 | 
|---|
| 642 | /*!
 | 
|---|
| 643 |   If \a enable is TRUE the page \a w is enabled; otherwise \a w is
 | 
|---|
| 644 |   disabled. The page's tab is redrawn appropriately.
 | 
|---|
| 645 | 
 | 
|---|
| 646 |   QTabWidget uses QWidget::setEnabled() internally, rather than keeping a
 | 
|---|
| 647 |   separate flag.
 | 
|---|
| 648 | 
 | 
|---|
| 649 |   Note that even a disabled tab and tab page may be visible. If the
 | 
|---|
| 650 |   page is already visible QTabWidget will not hide it; if all the
 | 
|---|
| 651 |   pages are disabled QTabWidget will show one of them.
 | 
|---|
| 652 | 
 | 
|---|
| 653 |   \sa isTabEnabled(), QWidget::setEnabled()
 | 
|---|
| 654 | */
 | 
|---|
| 655 | 
 | 
|---|
| 656 | void QTabDialog::setTabEnabled( QWidget* w, bool enable)
 | 
|---|
| 657 | {
 | 
|---|
| 658 |     d->tw->setTabEnabled( w, enable );
 | 
|---|
| 659 | }
 | 
|---|
| 660 | 
 | 
|---|
| 661 | 
 | 
|---|
| 662 | /*!
 | 
|---|
| 663 |   Adds an Apply button to the dialog. The button's text is set to \a
 | 
|---|
| 664 |   text.
 | 
|---|
| 665 | 
 | 
|---|
| 666 |   The Apply button should apply the current settings in the dialog box
 | 
|---|
| 667 |   to the application while keeping the dialog visible.
 | 
|---|
| 668 | 
 | 
|---|
| 669 |   When Apply is clicked, the applyButtonPressed() signal is emitted.
 | 
|---|
| 670 | 
 | 
|---|
| 671 |   If \a text is a
 | 
|---|
| 672 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 673 |   no button is shown.
 | 
|---|
| 674 | 
 | 
|---|
| 675 |   \sa setCancelButton() setDefaultButton() applyButtonPressed()
 | 
|---|
| 676 | */
 | 
|---|
| 677 | void QTabDialog::setApplyButton( const QString &text )
 | 
|---|
| 678 | {
 | 
|---|
| 679 |     if ( !text && d->ab ) {
 | 
|---|
| 680 |         delete d->ab;
 | 
|---|
| 681 |         d->ab = 0;
 | 
|---|
| 682 |         setSizes();
 | 
|---|
| 683 |     } else {
 | 
|---|
| 684 |         if ( !d->ab ) {
 | 
|---|
| 685 |             d->ab = new QPushButton( this, "apply settings" );
 | 
|---|
| 686 |             connect( d->ab, SIGNAL(clicked()),
 | 
|---|
| 687 |                      this, SIGNAL(applyButtonPressed()) );
 | 
|---|
| 688 |             setUpLayout();
 | 
|---|
| 689 |         }
 | 
|---|
| 690 |         d->ab->setText( text );
 | 
|---|
| 691 |         setSizes();
 | 
|---|
| 692 |         //d->ab->show();
 | 
|---|
| 693 |     }
 | 
|---|
| 694 | }
 | 
|---|
| 695 | 
 | 
|---|
| 696 | /*!
 | 
|---|
| 697 |     \overload
 | 
|---|
| 698 | 
 | 
|---|
| 699 |   Adds an Apply button to the dialog. The button's text is set to
 | 
|---|
| 700 |   a localizable "Apply".
 | 
|---|
| 701 |  */
 | 
|---|
| 702 | void QTabDialog::setApplyButton()
 | 
|---|
| 703 | {
 | 
|---|
| 704 |     setApplyButton( tr("Apply") );
 | 
|---|
| 705 | }
 | 
|---|
| 706 | 
 | 
|---|
| 707 | 
 | 
|---|
| 708 | /*!
 | 
|---|
| 709 |   Adds a Help button to the dialog. The button's text is set to \a
 | 
|---|
| 710 |   text.
 | 
|---|
| 711 | 
 | 
|---|
| 712 |   When Help is clicked, the helpButtonPressed() signal is emitted.
 | 
|---|
| 713 | 
 | 
|---|
| 714 |   If \a text is a
 | 
|---|
| 715 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 716 |   no button is shown.
 | 
|---|
| 717 | 
 | 
|---|
| 718 |   \sa setApplyButton() setCancelButton() helpButtonPressed()
 | 
|---|
| 719 | */
 | 
|---|
| 720 | 
 | 
|---|
| 721 | void QTabDialog::setHelpButton( const QString &text )
 | 
|---|
| 722 | {
 | 
|---|
| 723 |     if ( !text ) {
 | 
|---|
| 724 |         delete d->hb;
 | 
|---|
| 725 |         d->hb = 0;
 | 
|---|
| 726 |         setSizes();
 | 
|---|
| 727 |     } else {
 | 
|---|
| 728 |         if ( !d->hb ) {
 | 
|---|
| 729 |             d->hb = new QPushButton( this, "give help" );
 | 
|---|
| 730 |             connect( d->hb, SIGNAL(clicked()),
 | 
|---|
| 731 |                      this, SIGNAL(helpButtonPressed()) );
 | 
|---|
| 732 |             setUpLayout();
 | 
|---|
| 733 |         }
 | 
|---|
| 734 |         d->hb->setText( text );
 | 
|---|
| 735 |         setSizes();
 | 
|---|
| 736 |         //d->hb->show();
 | 
|---|
| 737 |     }
 | 
|---|
| 738 | }
 | 
|---|
| 739 | 
 | 
|---|
| 740 | 
 | 
|---|
| 741 | /*!
 | 
|---|
| 742 |     \overload
 | 
|---|
| 743 | 
 | 
|---|
| 744 |   Adds a Help button to the dialog. The button's text is set to
 | 
|---|
| 745 |   a localizable "Help".
 | 
|---|
| 746 |  */
 | 
|---|
| 747 | void QTabDialog::setHelpButton()
 | 
|---|
| 748 | {
 | 
|---|
| 749 |     setHelpButton( tr("Help") );
 | 
|---|
| 750 | }
 | 
|---|
| 751 | 
 | 
|---|
| 752 | /*!
 | 
|---|
| 753 |   Adds a Defaults button to the dialog. The button's text is set to \a
 | 
|---|
| 754 |   text.
 | 
|---|
| 755 | 
 | 
|---|
| 756 |   The Defaults button should set the dialog (but not the application)
 | 
|---|
| 757 |   back to the application defaults.
 | 
|---|
| 758 | 
 | 
|---|
| 759 |   When Defaults is clicked, the defaultButtonPressed() signal is emitted.
 | 
|---|
| 760 | 
 | 
|---|
| 761 |   If \a text is a
 | 
|---|
| 762 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 763 |   no button is shown.
 | 
|---|
| 764 | 
 | 
|---|
| 765 |   \sa setApplyButton() setCancelButton() defaultButtonPressed()
 | 
|---|
| 766 | */
 | 
|---|
| 767 | 
 | 
|---|
| 768 | void QTabDialog::setDefaultButton( const QString &text )
 | 
|---|
| 769 | {
 | 
|---|
| 770 |     if ( !text ) {
 | 
|---|
| 771 |         delete d->db;
 | 
|---|
| 772 |         d->db = 0;
 | 
|---|
| 773 |         setSizes();
 | 
|---|
| 774 |     } else {
 | 
|---|
| 775 |         if ( !d->db ) {
 | 
|---|
| 776 |             d->db = new QPushButton( this, "back to default" );
 | 
|---|
| 777 |             connect( d->db, SIGNAL(clicked()),
 | 
|---|
| 778 |                      this, SIGNAL(defaultButtonPressed()) );
 | 
|---|
| 779 |             setUpLayout();
 | 
|---|
| 780 |         }
 | 
|---|
| 781 |         d->db->setText( text );
 | 
|---|
| 782 |         setSizes();
 | 
|---|
| 783 |         //d->db->show();
 | 
|---|
| 784 |     }
 | 
|---|
| 785 | }
 | 
|---|
| 786 | 
 | 
|---|
| 787 | 
 | 
|---|
| 788 | /*!
 | 
|---|
| 789 |     \overload
 | 
|---|
| 790 | 
 | 
|---|
| 791 |   Adds a Defaults button to the dialog. The button's text is set to
 | 
|---|
| 792 |   a localizable "Defaults".
 | 
|---|
| 793 |  */
 | 
|---|
| 794 | void QTabDialog::setDefaultButton()
 | 
|---|
| 795 | {
 | 
|---|
| 796 |     setDefaultButton( tr("Defaults") );
 | 
|---|
| 797 | }
 | 
|---|
| 798 | 
 | 
|---|
| 799 | /*!
 | 
|---|
| 800 |   Adds a Cancel button to the dialog. The button's text is set to \a
 | 
|---|
| 801 |   text.
 | 
|---|
| 802 | 
 | 
|---|
| 803 |   The cancel button should always return the application to the state
 | 
|---|
| 804 |   it was in before the tab view popped up, or if the user has clicked
 | 
|---|
| 805 |   Apply, back to the state immediately after the last Apply.
 | 
|---|
| 806 | 
 | 
|---|
| 807 |   When Cancel is clicked, the cancelButtonPressed() signal is emitted.
 | 
|---|
| 808 |   The dialog is closed at the same time.
 | 
|---|
| 809 | 
 | 
|---|
| 810 |   If \a text is a
 | 
|---|
| 811 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 812 |   no button is shown.
 | 
|---|
| 813 | 
 | 
|---|
| 814 |   \sa setApplyButton() setDefaultButton() cancelButtonPressed()
 | 
|---|
| 815 | */
 | 
|---|
| 816 | 
 | 
|---|
| 817 | void QTabDialog::setCancelButton( const QString &text )
 | 
|---|
| 818 | {
 | 
|---|
| 819 |     if ( !text ) {
 | 
|---|
| 820 |         delete d->cb;
 | 
|---|
| 821 |         d->cb = 0;
 | 
|---|
| 822 |         setSizes();
 | 
|---|
| 823 |     } else {
 | 
|---|
| 824 |         if ( !d->cb ) {
 | 
|---|
| 825 |             d->cb = new QPushButton( this, "cancel dialog" );
 | 
|---|
| 826 |             connect( d->cb, SIGNAL(clicked()),
 | 
|---|
| 827 |                      this, SIGNAL(cancelButtonPressed()) );
 | 
|---|
| 828 |             connect( d->cb, SIGNAL(clicked()),
 | 
|---|
| 829 |                      this, SLOT(reject()) );
 | 
|---|
| 830 |             setUpLayout();
 | 
|---|
| 831 |         }
 | 
|---|
| 832 |         d->cb->setText( text );
 | 
|---|
| 833 |         setSizes();
 | 
|---|
| 834 |         //d->cb->show();
 | 
|---|
| 835 |     }
 | 
|---|
| 836 | }
 | 
|---|
| 837 | 
 | 
|---|
| 838 | 
 | 
|---|
| 839 | /*!
 | 
|---|
| 840 |     \overload
 | 
|---|
| 841 | 
 | 
|---|
| 842 |   Adds a Cancel button to the dialog. The button's text is set to
 | 
|---|
| 843 |   a localizable "Cancel".
 | 
|---|
| 844 |  */
 | 
|---|
| 845 | 
 | 
|---|
| 846 | void QTabDialog::setCancelButton()
 | 
|---|
| 847 | {
 | 
|---|
| 848 |     setCancelButton( tr("Cancel") );
 | 
|---|
| 849 | }
 | 
|---|
| 850 | 
 | 
|---|
| 851 | 
 | 
|---|
| 852 | /*!  Sets up the layout manager for the tab dialog.
 | 
|---|
| 853 | 
 | 
|---|
| 854 |   \sa setSizes() setApplyButton() setCancelButton() setDefaultButton()
 | 
|---|
| 855 | */
 | 
|---|
| 856 | 
 | 
|---|
| 857 | void QTabDialog::setUpLayout()
 | 
|---|
| 858 | {
 | 
|---|
| 859 |     // the next four are probably the same, really?
 | 
|---|
| 860 |     const int topMargin = 6;
 | 
|---|
| 861 |     const int leftMargin = 6;
 | 
|---|
| 862 |     const int rightMargin = 6;
 | 
|---|
| 863 |     const int bottomMargin = 6;
 | 
|---|
| 864 |     const int betweenButtonsMargin = 7;
 | 
|---|
| 865 |     const int aboveButtonsMargin = 8;
 | 
|---|
| 866 | 
 | 
|---|
| 867 |     delete d->tll;
 | 
|---|
| 868 |     d->tll = new QBoxLayout( this, QBoxLayout::Down );
 | 
|---|
| 869 | 
 | 
|---|
| 870 |     // top margin
 | 
|---|
| 871 |     d->tll->addSpacing( topMargin );
 | 
|---|
| 872 | 
 | 
|---|
| 873 |     QBoxLayout * tmp = new QHBoxLayout();
 | 
|---|
| 874 |     d->tll->addLayout( tmp, 1 );
 | 
|---|
| 875 |     tmp->addSpacing( leftMargin );
 | 
|---|
| 876 |     tmp->addWidget( d->tw, 1);
 | 
|---|
| 877 |     tmp->addSpacing( rightMargin + 2 );
 | 
|---|
| 878 | 
 | 
|---|
| 879 |     d->tll->addSpacing( aboveButtonsMargin + 2 );
 | 
|---|
| 880 |     QBoxLayout * buttonRow = new QBoxLayout(QBoxLayout::RightToLeft);
 | 
|---|
| 881 |     d->tll->addLayout( buttonRow, 0 );
 | 
|---|
| 882 |     d->tll->addSpacing( bottomMargin );
 | 
|---|
| 883 | 
 | 
|---|
| 884 |     buttonRow->addSpacing( rightMargin );
 | 
|---|
| 885 |     if ( d->cb ) {
 | 
|---|
| 886 |         buttonRow->addWidget( d->cb, 0 );
 | 
|---|
| 887 |         buttonRow->addSpacing( betweenButtonsMargin );
 | 
|---|
| 888 |         d->cb->raise();
 | 
|---|
| 889 |     }
 | 
|---|
| 890 | 
 | 
|---|
| 891 |     if ( d->ab ) {
 | 
|---|
| 892 |         buttonRow->addWidget( d->ab, 0 );
 | 
|---|
| 893 |         buttonRow->addSpacing( betweenButtonsMargin );
 | 
|---|
| 894 |         d->ab->raise();
 | 
|---|
| 895 |     }
 | 
|---|
| 896 | 
 | 
|---|
| 897 |     if ( d->db ) {
 | 
|---|
| 898 |         buttonRow->addWidget( d->db, 0 );
 | 
|---|
| 899 |         buttonRow->addSpacing( betweenButtonsMargin );
 | 
|---|
| 900 |         d->db->raise();
 | 
|---|
| 901 |     }
 | 
|---|
| 902 | 
 | 
|---|
| 903 |     if ( d->hb ) {
 | 
|---|
| 904 |         buttonRow->addWidget( d->hb, 0 );
 | 
|---|
| 905 |         buttonRow->addSpacing( betweenButtonsMargin );
 | 
|---|
| 906 |         d->hb->raise();
 | 
|---|
| 907 |     }
 | 
|---|
| 908 | 
 | 
|---|
| 909 |     if ( d->ok ) {
 | 
|---|
| 910 |         buttonRow->addWidget( d->ok, 0 );
 | 
|---|
| 911 |         buttonRow->addSpacing( betweenButtonsMargin );
 | 
|---|
| 912 |         d->ok->raise();
 | 
|---|
| 913 |     }
 | 
|---|
| 914 | 
 | 
|---|
| 915 |     // add one custom widget here
 | 
|---|
| 916 |     buttonRow->addStretch( 1 );
 | 
|---|
| 917 |     // add another custom widget here
 | 
|---|
| 918 | 
 | 
|---|
| 919 |     d->tll->activate();
 | 
|---|
| 920 | }
 | 
|---|
| 921 | 
 | 
|---|
| 922 | 
 | 
|---|
| 923 | /*!  Sets up the minimum and maximum sizes for each child widget.
 | 
|---|
| 924 | 
 | 
|---|
| 925 |   \sa setUpLayout() setFont()
 | 
|---|
| 926 | */
 | 
|---|
| 927 | 
 | 
|---|
| 928 | void QTabDialog::setSizes()
 | 
|---|
| 929 | {
 | 
|---|
| 930 |     // compute largest button size
 | 
|---|
| 931 |     QSize s( 0, 0 );
 | 
|---|
| 932 |     int bw = s.width();
 | 
|---|
| 933 |     int bh = s.height();
 | 
|---|
| 934 | 
 | 
|---|
| 935 |     if ( d->ok ) {
 | 
|---|
| 936 |         s = d->ok->sizeHint();
 | 
|---|
| 937 |         if ( s.width() > bw )
 | 
|---|
| 938 |             bw = s.width();
 | 
|---|
| 939 |         if ( s.height() > bh )
 | 
|---|
| 940 |             bh = s.height();
 | 
|---|
| 941 |     }
 | 
|---|
| 942 | 
 | 
|---|
| 943 |     if ( d->ab ) {
 | 
|---|
| 944 |         s = d->ab->sizeHint();
 | 
|---|
| 945 |         if ( s.width() > bw )
 | 
|---|
| 946 |             bw = s.width();
 | 
|---|
| 947 |         if ( s.height() > bh )
 | 
|---|
| 948 |             bh = s.height();
 | 
|---|
| 949 |     }
 | 
|---|
| 950 | 
 | 
|---|
| 951 |     if ( d->db ) {
 | 
|---|
| 952 |         s = d->db->sizeHint();
 | 
|---|
| 953 |         if ( s.width() > bw )
 | 
|---|
| 954 |             bw = s.width();
 | 
|---|
| 955 |         if ( s.height() > bh )
 | 
|---|
| 956 |             bh = s.height();
 | 
|---|
| 957 |     }
 | 
|---|
| 958 | 
 | 
|---|
| 959 |     if ( d->hb ) {
 | 
|---|
| 960 |         s = d->hb->sizeHint();
 | 
|---|
| 961 |         if ( s.width() > bw )
 | 
|---|
| 962 |             bw = s.width();
 | 
|---|
| 963 |         if ( s.height() > bh )
 | 
|---|
| 964 |             bh = s.height();
 | 
|---|
| 965 |     }
 | 
|---|
| 966 | 
 | 
|---|
| 967 |     if ( d->cb ) {
 | 
|---|
| 968 |         s = d->cb->sizeHint();
 | 
|---|
| 969 |         if ( s.width() > bw )
 | 
|---|
| 970 |             bw = s.width();
 | 
|---|
| 971 |         if ( s.height() > bh )
 | 
|---|
| 972 |             bh = s.height();
 | 
|---|
| 973 |     }
 | 
|---|
| 974 | 
 | 
|---|
| 975 |     // and set all the buttons to that size
 | 
|---|
| 976 |     if ( d->ok )
 | 
|---|
| 977 |         d->ok->setFixedSize( bw, bh );
 | 
|---|
| 978 |     if ( d->ab )
 | 
|---|
| 979 |         d->ab->setFixedSize( bw, bh );
 | 
|---|
| 980 |     if ( d->db )
 | 
|---|
| 981 |         d->db->setFixedSize( bw, bh );
 | 
|---|
| 982 |     if ( d->hb )
 | 
|---|
| 983 |         d->hb->setFixedSize( bw, bh );
 | 
|---|
| 984 |     if ( d->cb )
 | 
|---|
| 985 |         d->cb->setFixedSize( bw, bh );
 | 
|---|
| 986 | 
 | 
|---|
| 987 |     // fiddle the tab chain so the buttons are in their natural order
 | 
|---|
| 988 |     QWidget * w = d->ok;
 | 
|---|
| 989 | 
 | 
|---|
| 990 |     if ( d->hb ) {
 | 
|---|
| 991 |         if ( w )
 | 
|---|
| 992 |             setTabOrder( w, d->hb );
 | 
|---|
| 993 |         w = d->hb;
 | 
|---|
| 994 |     }
 | 
|---|
| 995 |     if ( d->db ) {
 | 
|---|
| 996 |         if ( w )
 | 
|---|
| 997 |             setTabOrder( w, d->db );
 | 
|---|
| 998 |         w = d->db;
 | 
|---|
| 999 |     }
 | 
|---|
| 1000 |     if ( d->ab ) {
 | 
|---|
| 1001 |         if ( w )
 | 
|---|
| 1002 |             setTabOrder( w, d->ab );
 | 
|---|
| 1003 |         w = d->ab;
 | 
|---|
| 1004 |     }
 | 
|---|
| 1005 |     if ( d->cb ) {
 | 
|---|
| 1006 |         if ( w )
 | 
|---|
| 1007 |             setTabOrder( w, d->cb );
 | 
|---|
| 1008 |         w = d->cb;
 | 
|---|
| 1009 |     }
 | 
|---|
| 1010 |     setTabOrder( w, d->tw );
 | 
|---|
| 1011 | }
 | 
|---|
| 1012 | 
 | 
|---|
| 1013 | /*!\reimp
 | 
|---|
| 1014 | */
 | 
|---|
| 1015 | void QTabDialog::resizeEvent( QResizeEvent * e )
 | 
|---|
| 1016 | {
 | 
|---|
| 1017 |     QDialog::resizeEvent( e );
 | 
|---|
| 1018 | }
 | 
|---|
| 1019 | 
 | 
|---|
| 1020 | 
 | 
|---|
| 1021 | /*!\reimp
 | 
|---|
| 1022 | */
 | 
|---|
| 1023 | void QTabDialog::paintEvent( QPaintEvent * )
 | 
|---|
| 1024 | {
 | 
|---|
| 1025 | }
 | 
|---|
| 1026 | 
 | 
|---|
| 1027 | 
 | 
|---|
| 1028 | /*!
 | 
|---|
| 1029 |   Adds an OK button to the dialog and sets the button's text to \a text.
 | 
|---|
| 1030 | 
 | 
|---|
| 1031 |   When the OK button is clicked, the applyButtonPressed() signal is emitted,
 | 
|---|
| 1032 |   and the current settings in the dialog box should be applied to
 | 
|---|
| 1033 |   the application. The dialog then closes.
 | 
|---|
| 1034 | 
 | 
|---|
| 1035 |   If \a text is a
 | 
|---|
| 1036 |   \link QString::operator!() null string\endlink,
 | 
|---|
| 1037 |   no button is shown.
 | 
|---|
| 1038 | 
 | 
|---|
| 1039 |   \sa setCancelButton() setDefaultButton() applyButtonPressed()
 | 
|---|
| 1040 | */
 | 
|---|
| 1041 | 
 | 
|---|
| 1042 | void QTabDialog::setOkButton( const QString &text )
 | 
|---|
| 1043 | {
 | 
|---|
| 1044 |     if ( !text ) {
 | 
|---|
| 1045 |         delete d->ok;
 | 
|---|
| 1046 |         d->ok = 0;
 | 
|---|
| 1047 |         setSizes();
 | 
|---|
| 1048 |     } else {
 | 
|---|
| 1049 |         if ( !d->ok ) {
 | 
|---|
| 1050 |             d->ok = new QPushButton( this, "ok" );
 | 
|---|
| 1051 |             connect( d->ok, SIGNAL(clicked()),
 | 
|---|
| 1052 |                      this, SIGNAL(applyButtonPressed()) );
 | 
|---|
| 1053 |             setUpLayout();
 | 
|---|
| 1054 |         }
 | 
|---|
| 1055 |         d->ok->setText( text );
 | 
|---|
| 1056 |         setSizes();
 | 
|---|
| 1057 |         //d->ok->show();
 | 
|---|
| 1058 |     }
 | 
|---|
| 1059 | }
 | 
|---|
| 1060 | /*!
 | 
|---|
| 1061 |   \overload
 | 
|---|
| 1062 | 
 | 
|---|
| 1063 |   Adds an OK button to the dialog. The button's text is set to
 | 
|---|
| 1064 |   a localizable "OK".
 | 
|---|
| 1065 |  */
 | 
|---|
| 1066 | 
 | 
|---|
| 1067 | void QTabDialog::setOkButton()
 | 
|---|
| 1068 | {
 | 
|---|
| 1069 |     setOkButton( tr("OK") );
 | 
|---|
| 1070 | }
 | 
|---|
| 1071 | 
 | 
|---|
| 1072 | 
 | 
|---|
| 1073 | /*
 | 
|---|
| 1074 |     \overload
 | 
|---|
| 1075 |   Old version of setOkButton(), provided for backward compatibility.
 | 
|---|
| 1076 | */
 | 
|---|
| 1077 | void QTabDialog::setOKButton( const QString &text )
 | 
|---|
| 1078 | {
 | 
|---|
| 1079 |     // Ugly workaround for original "OK" default argument
 | 
|---|
| 1080 |     QString newText( text );
 | 
|---|
| 1081 |     if ( text.isNull() )
 | 
|---|
| 1082 |         newText = QString::fromLatin1( "OK" );
 | 
|---|
| 1083 |     setOkButton( newText );
 | 
|---|
| 1084 | }
 | 
|---|
| 1085 | 
 | 
|---|
| 1086 | 
 | 
|---|
| 1087 | /*!  Returns the text in the tab for page \a w.
 | 
|---|
| 1088 | */
 | 
|---|
| 1089 | 
 | 
|---|
| 1090 | QString QTabDialog::tabLabel( QWidget * w )
 | 
|---|
| 1091 | {
 | 
|---|
| 1092 |     return d->tw->tabLabel( w );
 | 
|---|
| 1093 | }
 | 
|---|
| 1094 | 
 | 
|---|
| 1095 | 
 | 
|---|
| 1096 | /*!  \reimp
 | 
|---|
| 1097 | */
 | 
|---|
| 1098 | void QTabDialog::styleChange( QStyle& s )
 | 
|---|
| 1099 | {
 | 
|---|
| 1100 |     QDialog::styleChange( s );
 | 
|---|
| 1101 |     setSizes();
 | 
|---|
| 1102 | }
 | 
|---|
| 1103 | 
 | 
|---|
| 1104 | 
 | 
|---|
| 1105 | /*!  Returns a pointer to the page currently being displayed by the
 | 
|---|
| 1106 | tab dialog. The tab dialog does its best to make sure that this value
 | 
|---|
| 1107 | is never 0 (but if you try hard enough, it can be).
 | 
|---|
| 1108 | */
 | 
|---|
| 1109 | 
 | 
|---|
| 1110 | QWidget * QTabDialog::currentPage() const
 | 
|---|
| 1111 | {
 | 
|---|
| 1112 |     return d->tw->currentPage();
 | 
|---|
| 1113 | }
 | 
|---|
| 1114 | 
 | 
|---|
| 1115 | /*!
 | 
|---|
| 1116 |  \overload
 | 
|---|
| 1117 |   Defines a new \a label for the tab of page \a w
 | 
|---|
| 1118 |  */
 | 
|---|
| 1119 | void QTabDialog::changeTab( QWidget *w, const QString &label)
 | 
|---|
| 1120 | {
 | 
|---|
| 1121 |     d->tw->changeTab( w, label );
 | 
|---|
| 1122 | }
 | 
|---|
| 1123 | 
 | 
|---|
| 1124 | /*!
 | 
|---|
| 1125 |     Changes tab page \a w's iconset to \a iconset and label to \a label.
 | 
|---|
| 1126 | 
 | 
|---|
| 1127 |  */
 | 
|---|
| 1128 | void QTabDialog::changeTab( QWidget *w, const QIconSet& iconset, const QString &label)
 | 
|---|
| 1129 | {
 | 
|---|
| 1130 |     d->tw->changeTab( w, iconset, label );
 | 
|---|
| 1131 | }
 | 
|---|
| 1132 | 
 | 
|---|
| 1133 | /*! Removes page \a w from this stack of widgets. Does not
 | 
|---|
| 1134 |   delete \a w.
 | 
|---|
| 1135 |   \sa showPage(), QTabWidget::removePage(), QWidgetStack::removeWidget()
 | 
|---|
| 1136 | */
 | 
|---|
| 1137 | void QTabDialog::removePage( QWidget * w )
 | 
|---|
| 1138 | {
 | 
|---|
| 1139 |     d->tw->removePage( w );
 | 
|---|
| 1140 | }
 | 
|---|
| 1141 | 
 | 
|---|
| 1142 | #endif
 | 
|---|