diff options
Diffstat (limited to 'src/widgets/doc/src/widgets-and-layouts/widgets.qdoc')
| -rw-r--r-- | src/widgets/doc/src/widgets-and-layouts/widgets.qdoc | 157 |
1 files changed, 59 insertions, 98 deletions
diff --git a/src/widgets/doc/src/widgets-and-layouts/widgets.qdoc b/src/widgets/doc/src/widgets-and-layouts/widgets.qdoc index 38e7eb6929..c8c16fdd54 100644 --- a/src/widgets/doc/src/widgets-and-layouts/widgets.qdoc +++ b/src/widgets/doc/src/widgets-and-layouts/widgets.qdoc @@ -26,137 +26,98 @@ ****************************************************************************/ /*! - \page widgets-and-layouts.html - \title Widgets and Layouts + \page widget-classes.html + \title Widgets Classes \ingroup qt-gui-concepts \brief The primary elements for designing user interfaces in Qt. - \section1 Widgets + \section1 The Widget Classes - Widgets are the primary elements for creating user interfaces in Qt. - \l{The Widget Classes}{Widgets} can display data and status information, - receive user input, and provide a container for other widgets that - should be grouped together. A widget that is not embedded in a - parent widget is called a \l{Window and Dialog Widgets} {window}. + The following sections list the widget classes. See the \l{Qt Widget + Gallery} for some examples. - \image parent-child-widgets.png A parent widget containing various child widgets. + \section2 Basic Widget Classes - The QWidget class provides the basic capability to render to the - screen, and to handle user input events. All UI elements that Qt - provides are either subclasses of QWidget, or are used in connection - with a QWidget subclass. Creating custom widgets is done by - subclassing QWidget or a suitable subclass and reimplementing the - virtual event handlers. + These basic widgets (controls), e.g. buttons, comboboxes and + scroll bars, are designed for direct use. - \section1 Layouts + \table + \row + \li \image windows-label.png + \li \image windowsvista-pushbutton.png + \li \image gtk-progressbar.png + \row + \li \image plastique-combobox.png + \li \image macintosh-radiobutton.png + \li \image cde-lineedit.png + \endtable - \l{Layout Management}{Layouts} are an elegant and flexible way to - automatically arrange child widgets within their container. Each - widget reports its size requirements to the layout through the - \l{QWidget::}{sizeHint} and \l{QWidget::}{sizePolicy} properties, - and the layout distributes the available space accordingly. + \annotatedlist basicwidgets - \table - \row - \li \image qgridlayout-with-5-children.png - \li \image qformlayout-with-6-children.png - \endtable + \table + \row + \li \image windowsvista-tabwidget.png + \li \image macintosh-groupbox.png + \endtable - Qt Designer is a powerful tool for interactively creating and - arranging widgets in layouts. - \section1 Widget Styles + \section2 Advanced Widget Classes - \l{Styles and Style Aware Widgets}{Styles} draw on behalf of - widgets and encapsulate the look and feel of a GUI. Qt's built-in - widgets use the QStyle class to perform nearly all of their drawing, - ensuring that they look exactly like the equivalent native widgets. + Advanced GUI widgets, e.g. tab widgets and progress bars, provide + more complex user interface controls. - \table - \row - \li \image windowsxp-tabwidget.png - \li \image plastique-tabwidget.png - \li \image macintosh-tabwidget.png - \endtable + \table + \row + \li \image windowsxp-treeview.png + \li \image gtk-calendarwidget.png + \li \image qundoview.png + \endtable - \l{Qt Style Sheets} are a powerful mechanism that allows you to customize the - appearance of widgets, in addition to what is already possible by subclassing QStyle. + \annotatedlist advanced - \section1 The Widget Classes - The following sections list the widget classes. See the \l{Qt Widget - Gallery} for some examples. + \section2 Abstract Widget Classes - \section2 Basic Widgets + The abstract widget classes are base classes. They are not usable as + standalone classes but provide functionality when they are subclassed. - These basic widgets (controls), e.g. buttons, comboboxes and - scroll bars, are designed for direct use. + \annotatedlist abstractwidgets - \table - \row - \li \image windows-label.png - \li \image windowsvista-pushbutton.png - \li \image gtk-progressbar.png - \row - \li \image plastique-combobox.png - \li \image macintosh-radiobutton.png - \li \image cde-lineedit.png - \endtable - \annotatedlist basicwidgets + \section2 Organizer Widget Classes - \section2 Advanced Widgets + Classes like splitters, tab bars, button groups, etc are used for + organizing and grouping GUI primitives into more complex + applications and dialogs. - Advanced GUI widgets, e.g. tab widgets and progress bars, provide - more complex user interface controls. + \annotatedlist organizers - \table - \row - \li \image windowsxp-treeview.png - \li \image gtk-calendarwidget.png - \li \image qundoview.png - \endtable - \annotatedlist advanced + \section2 Graphics View Classes - \table - \row - \li \image windowsvista-tabwidget.png - \li \image macintosh-groupbox.png - \endtable + \annotatedlist graphicsview-api - \section2 Organizer Widgets - Classes like splitters, tab bars, button groups, etc are used for - organizing and grouping GUI primitives into more complex - applications and dialogs. + \section2 Model/View Classes - \annotatedlist organizers + \annotatedlist model-view - \section2 Abstract Widget Classes - The abstract widget classes are base classes. They are not usable as - standalone classes but provide functionality when they are subclassed. + \section2 Main Window and Related Classes - \annotatedlist abstractwidgets -*/ + \annotatedlist mainwindow-classes -/*! - \group advanced - \title Advanced Widgets -*/ -/*! - \group abstractwidgets - \title Abstract Widget Classes -*/ + \section2 Widget Appearance and Style-Related Classes + Classes used for customizing UI appearance and style. + + \annotatedlist appearance + + + \section2 Layout Classes + \annotatedlist geomanagement -/*! - \group basicwidgets - \title Basic Widgets -*/ -/*! - \group organizers - \title Organizers */ + + |