summaryrefslogtreecommitdiffstats
path: root/doc/pictures.doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pictures.doc')
-rw-r--r--doc/pictures.doc147
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
+
+*/