doc/src/widgets/windows-and-dialogs/dialogs.qdoc

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the documentation of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:FDL$
  10 ** GNU Free Documentation License
  11 ** Alternatively, this file may be used under the terms of the GNU Free
  12 ** Documentation License version 1.3 as published by the Free Software
  13 ** Foundation and appearing in the file included in the packaging of
  14 ** this file.
  15 **
  16 ** Other Usage
  17 ** Alternatively, this file may be used in accordance with the terms
  18 ** and conditions contained in a signed written agreement between you
  19 ** and Nokia.
  20 **
  21 **
  22 **
  23 **
  24 ** $QT_END_LICENSE$
  25 **
  26 ****************************************************************************/
  27
  28 /*!
  29     \group standard-dialogs
  30     \ingroup qt-gui-concepts
  31     \title Standard Dialogs
  32     \brief A list of Qt classes for implementing standard dialogs.
  33 */
  34
  35 /*!
  36     \page dialogs.html
  37     \title Dialog Windows
  38     \ingroup qt-gui-concepts
  39     \brief An overview over dialog windows.
  40
  41     \previouspage Application Main Window
  42     \contentspage Application Windows and Dialogs
  43     \nextpage Desktop Integration
  44
  45     Dialogs can be \e{modal}, in which case the user is required to provide
  46     necessary information before work in the main window
  47     can continue, or \e{modeless}. Modeless dialogs do not prevent the user from
  48     interacting with any of the other windows in the application.
  49
  50     Qt provides a set of ready-made dialogs for file, font, color-selection
  51     and more.
  52
  53     \annotatedlist standard-dialogs
  54
  55     Custom dialogs can be easily created by composing regular widgets into
  56     a QDialog. These classes are specifically designed for building custom
  57     dialogs:
  58
  59     \annotatedlist dialog-classes
  60 */