diff options
Diffstat (limited to 'doc/pictures.doc')
-rw-r--r-- | doc/pictures.doc | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/doc/pictures.doc b/doc/pictures.doc new file mode 100644 index 000000000..b3651eca2 --- /dev/null +++ b/doc/pictures.doc @@ -0,0 +1,147 @@ +/**************************************************************************** +** +** Pictures of Most Widgets in Qt +** +** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. +** +** This file is part of the Qt GUI Toolkit. +** +** This file may be used under the terms of the GNU General +** Public License versions 2.0 or 3.0 as published by the Free +** Software Foundation and appearing in the files LICENSE.GPL2 +** and LICENSE.GPL3 included in the packaging of this file. +** Alternatively you may (at your option) use any later version +** of the GNU General Public License if such license has been +** publicly approved by Trolltech ASA (or its successors, if any) +** and the KDE Free Qt Foundation. +** +** Please review the following information to ensure GNU General +** Public Licensing retquirements will be met: +** http://trolltech.com/products/qt/licenses/licensing/opensource/. +** If you are unsure which license is appropriate for your use, please +** review the following information: +** http://trolltech.com/products/qt/licenses/licensing/licensingoverview +** or contact the sales department at sales@trolltech.com. +** +** This file may be used under the terms of the Q Public License as +** defined by Trolltech ASA and appearing in the file LICENSE.QPL +** included in the packaging of this file. Licensees holding valid Qt +** Commercial licenses may use this file in accordance with the Qt +** Commercial License Agreement provided with the Software. +** +** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, +** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted +** herein. +** +**********************************************************************/ + +/*! +\page pictures.html + +\title Pictures of Most Qt Widgets + +Most of these widgets are shown in either Motif or Windows style. +All widgets are supported in both styles (and other \link QStyle +styles\endlink), but for clarity we just present a selection. + +Qt provides more widgets than the selection shown below. And extra Qt +are available from third parties, and as add-ons to Qt; see \link +http://www.trolltech.com/products/solutions/index.html Qt +Solutions\endlink, and \link +http://www.trolltech.com/freesoftware/index.html User contributed Qt +additions\endlink. + +\omit +Below is a screen shot of the demo example running under Linux. It +shows off many of Qt's widgets. (The source is in \c{examples/demo}. + +\img demo-screenshot.png +\endomit + + +Below we have three views seperated by \l {QSplitter}s. At the +top-left there's a \l QListBox, at the top-right there's a \l +QListView with a \l QHeader and two \l {QScrollBar}s. And at the +bottom there's a \l QIconView. + +\img splitter-views-w.png + +Below we present a \l QMainWindow which has +a \l QMenuBar and some \l {QToolBar}s that contain +various widgets, e.g. \l {QToolButton}s and \l {QComboBox}es. The central +widget is a \l QWorkspace which is used for MDI window management and +which contains an MDI-Window featuring a \l QTextEdit. At the bottom +you see a \l QStatusBar and at the bottom-right a \l QSizeGrip. + +\img mainwindow-w.png + +The image below shows a \l QFileDialog. On the Macintosh and Windows +platforms you can either use a QFileDialog or the native file +dialog. This is explained in the \l QFileDialog class documentation. + +\img qfiledlg-w.png + +Below is a QPrintDialog. On Macintosh and Windows the native print +dialog is used, but for other platforms we provide QPrintDialog. Use +QPrinter::setup() for portability instead of the QPrintDialog if you +need to be platform independent. + +\img qprintdlg-m.png + +Below is a \l QFontDialog. + +\img qfontdlg-w.png +\caption Windows + +The screenshot below shows a \l QColorDialog. + +\img qcolordlg-w.png + +Messages are presented using \l{QMessageBox}es, as shown below. + +\img qmsgbox-w.png + +The image below shows a \l QProgressDialog. The \l QProgressBar can +also be used as a separate widget. + +\img qprogdlg-w.png + +In the screenshot below we have a \l QGroupBox that contains a \l +QLineEdit, a read-only \l QComboBox and an editable \l QComboBox. + +\img groupbox-w.png + +The screenshot below shows a \l QPopupMenu. + +\img qpopmenu-w.png + +In the screenshot below there's a \l QButtonGroup containing four \l +{QRadioButton}s and two \l {QCheckBox}es. + +\img buttongroup-w.png + +\omit +THIS IMAGE DOESN'T SHOW ANYTHING UNDERSTANDABLY USEFUL + +All views in the first screenshot are widgets derived from a \l +QScrollView. But this class can also manage lots of child-widgets, +like in this screenshot. + +\img qscrollview-m.png +\endomit + +The screenshot below shows a \l QTabDialog. The tabs (\l QTabBar) or the +more convenient class \l QTabWidget, which combines a tab bar with +the pages, can be used separately. In the visible page you see a \l +QLabel, the range controls \l QSlider and \l QSpinBox and below a \l +QLCDNumber. In the bottom row there are some \l {QPushButton}s. + +\img qtabdlg-w.png + +In the screenshot below there's a \l QTextBrowser displaying a HTML +page. See also \l QTextEdit. + +\img qtextbrowser-w.png + +*/ |