diff options
Diffstat (limited to 'src/widgets')
78 files changed, 1272 insertions, 1272 deletions
diff --git a/src/widgets/dialogs/qdialog.cpp b/src/widgets/dialogs/qdialog.cpp index 5ffb5466d6..4170df4799 100644 --- a/src/widgets/dialogs/qdialog.cpp +++ b/src/widgets/dialogs/qdialog.cpp @@ -166,7 +166,7 @@ QVariant QDialogPrivate::styleHint(QPlatformDialogHelper::StyleHint hint) const \section1 Modal Dialogs - A \bold{modal} dialog is a dialog that blocks input to other + A \b{modal} dialog is a dialog that blocks input to other visible windows in the same application. Dialogs that are used to request a file name from the user or that are used to set application preferences are usually modal. Dialogs can be @@ -200,7 +200,7 @@ QVariant QDialogPrivate::styleHint(QPlatformDialogHelper::StyleHint hint) const \section1 Modeless Dialogs - A \bold{modeless} dialog is a dialog that operates + A \b{modeless} dialog is a dialog that operates independently of other windows in the same application. Find and replace dialogs in word-processors are often modeless to allow the user to interact with both the application's main window and with diff --git a/src/widgets/dialogs/qfiledialog.cpp b/src/widgets/dialogs/qfiledialog.cpp index 84fdef6702..3908daec9c 100644 --- a/src/widgets/dialogs/qfiledialog.cpp +++ b/src/widgets/dialogs/qfiledialog.cpp @@ -1096,7 +1096,7 @@ QStringList qt_make_filter_list(const QString &filter) Sets the filter used in the file dialog to the given \a filter. If \a filter contains a pair of parentheses containing one or more - of \bold{anything*something}, separated by spaces, then only the + of \b{anything*something}, separated by spaces, then only the text contained in the parentheses is used as the filter. This means that these calls are all equivalent: diff --git a/src/widgets/dialogs/qfilesystemmodel.cpp b/src/widgets/dialogs/qfilesystemmodel.cpp index 0211b2512c..5446eca383 100644 --- a/src/widgets/dialogs/qfilesystemmodel.cpp +++ b/src/widgets/dialogs/qfilesystemmodel.cpp @@ -130,12 +130,12 @@ QT_BEGIN_NAMESPACE \fn bool QFileSystemModel::rmdir(const QModelIndex &index) const Removes the directory corresponding to the model item \a index in the - file system model and \bold{deletes the corresponding directory from the + file system model and \b{deletes the corresponding directory from the file system}, returning true if successful. If the directory cannot be removed, false is returned. \warning This function deletes directories from the file system; it does - \bold{not} move them to a location where they can be recovered. + \b{not} move them to a location where they can be recovered. \sa remove() */ @@ -185,11 +185,11 @@ QT_BEGIN_NAMESPACE /*! \fn bool QFileSystemModel::remove(const QModelIndex &index) const - Removes the model item \a index from the file system model and \bold{deletes the + Removes the model item \a index from the file system model and \b{deletes the corresponding file from the file system}, returning true if successful. If the item cannot be removed, false is returned. - \warning This function deletes files from the file system; it does \bold{not} + \warning This function deletes files from the file system; it does \b{not} move them to a location where they can be recovered. \sa rmdir() diff --git a/src/widgets/dialogs/qinputdialog.cpp b/src/widgets/dialogs/qinputdialog.cpp index 9cf41003f5..737d6bb467 100644 --- a/src/widgets/dialogs/qinputdialog.cpp +++ b/src/widgets/dialogs/qinputdialog.cpp @@ -1031,10 +1031,10 @@ QString QInputDialog::cancelButtonText() const in \a member. These are: \list - \o textValueSelected() if \a member has a QString for its first argument. - \o intValueSelected() if \a member has an int for its first argument. - \o doubleValueSelected() if \a member has a double for its first argument. - \o accepted() if \a member has NO arguments. + \li textValueSelected() if \a member has a QString for its first argument. + \li intValueSelected() if \a member has an int for its first argument. + \li doubleValueSelected() if \a member has a double for its first argument. + \li accepted() if \a member has NO arguments. \endlist The signal will be disconnected from the slot when the dialog is closed. diff --git a/src/widgets/dialogs/qmessagebox.cpp b/src/widgets/dialogs/qmessagebox.cpp index a737584e3f..3909125fe7 100644 --- a/src/widgets/dialogs/qmessagebox.cpp +++ b/src/widgets/dialogs/qmessagebox.cpp @@ -577,21 +577,21 @@ void QMessageBoxPrivate::_q_buttonClicked(QAbstractButton *button) \table \row - \o \img qmessagebox-quest.png - \o \l Question - \o For asking a question during normal operations. + \li \img qmessagebox-quest.png + \li \l Question + \li For asking a question during normal operations. \row - \o \img qmessagebox-info.png - \o \l Information - \o For reporting information about normal operations. + \li \img qmessagebox-info.png + \li \l Information + \li For reporting information about normal operations. \row - \o \img qmessagebox-warn.png - \o \l Warning - \o For reporting non-critical errors. + \li \img qmessagebox-warn.png + \li \l Warning + \li For reporting non-critical errors. \row - \o \img qmessagebox-crit.png - \o \l Critical - \o For reporting critical errors. + \li \img qmessagebox-crit.png + \li \l Critical + \li For reporting critical errors. \endtable \l{QMessageBox::Icon}{Predefined icons} are not defined by QMessageBox, but @@ -663,13 +663,13 @@ void QMessageBoxPrivate::_q_buttonClicked(QAbstractButton *button) \list 1 - \o If there is only one button, it is the button activated when + \li If there is only one button, it is the button activated when \key Esc is pressed. - \o If there is a \l Cancel button, it is the button activated when + \li If there is a \l Cancel button, it is the button activated when \key Esc is pressed. - \o If there is exactly one button having either + \li If there is exactly one button having either \l{QMessageBox::RejectRole} {the Reject role} or the \l{QMessageBox::NoRole} {the No role}, it is the button activated when \key Esc is pressed. @@ -927,9 +927,9 @@ QAbstractButton *QMessageBox::button(StandardButton which) const escape button as follows: \list 1 - \o If there is only one button, it is made the escape button. - \o If there is a \l Cancel button, it is made the escape button. - \o On Mac OS X only, if there is exactly one button with the role + \li If there is only one button, it is made the escape button. + \li If there is a \l Cancel button, it is made the escape button. + \li On Mac OS X only, if there is exactly one button with the role QMessageBox::RejectRole, it is made the escape button. \endlist @@ -1142,11 +1142,11 @@ void QMessageBox::setText(const QString &text) values: \list - \o QMessageBox::NoIcon - \o QMessageBox::Question - \o QMessageBox::Information - \o QMessageBox::Warning - \o QMessageBox::Critical + \li QMessageBox::NoIcon + \li QMessageBox::Question + \li QMessageBox::Information + \li QMessageBox::Warning + \li QMessageBox::Critical \endlist The default is QMessageBox::NoIcon. @@ -1649,12 +1649,12 @@ QMessageBox::StandardButton QMessageBox::critical(QWidget *parent, const QString about() looks for a suitable icon in four locations: \list 1 - \o It prefers \link QWidget::windowIcon() parent->icon() \endlink + \li It prefers \link QWidget::windowIcon() parent->icon() \endlink if that exists. - \o If not, it tries the top-level widget containing \a parent. - \o If that fails, it tries the \link + \li If not, it tries the top-level widget containing \a parent. + \li If that fails, it tries the \link QApplication::activeWindow() active window. \endlink - \o As a last resort it uses the Information icon. + \li As a last resort it uses the Information icon. \endlist The about box has a single button labelled "OK". On Mac OS X, the @@ -1929,26 +1929,26 @@ void QMessageBoxPrivate::retranslateStrings() The \a icon must be one of the following: \list - \o QMessageBox::NoIcon - \o QMessageBox::Question - \o QMessageBox::Information - \o QMessageBox::Warning - \o QMessageBox::Critical + \li QMessageBox::NoIcon + \li QMessageBox::Question + \li QMessageBox::Information + \li QMessageBox::Warning + \li QMessageBox::Critical \endlist Each button, \a button0, \a button1 and \a button2, can have one of the following values: \list - \o QMessageBox::NoButton - \o QMessageBox::Ok - \o QMessageBox::Cancel - \o QMessageBox::Yes - \o QMessageBox::No - \o QMessageBox::Abort - \o QMessageBox::Retry - \o QMessageBox::Ignore - \o QMessageBox::YesAll - \o QMessageBox::NoAll + \li QMessageBox::NoButton + \li QMessageBox::Ok + \li QMessageBox::Cancel + \li QMessageBox::Yes + \li QMessageBox::No + \li QMessageBox::Abort + \li QMessageBox::Retry + \li QMessageBox::Ignore + \li QMessageBox::YesAll + \li QMessageBox::NoAll \endlist Use QMessageBox::NoButton for the later parameters to have fewer @@ -1994,16 +1994,16 @@ QMessageBox::QMessageBox(const QString &title, const QString &text, Icon icon, of the following values: \list - \o QMessageBox::NoButton - \o QMessageBox::Ok - \o QMessageBox::Cancel - \o QMessageBox::Yes - \o QMessageBox::No - \o QMessageBox::Abort - \o QMessageBox::Retry - \o QMessageBox::Ignore - \o QMessageBox::YesAll - \o QMessageBox::NoAll + \li QMessageBox::NoButton + \li QMessageBox::Ok + \li QMessageBox::Cancel + \li QMessageBox::Yes + \li QMessageBox::No + \li QMessageBox::Abort + \li QMessageBox::Retry + \li QMessageBox::Ignore + \li QMessageBox::YesAll + \li QMessageBox::NoAll \endlist If you don't want all three buttons, set the last button, or last @@ -2080,16 +2080,16 @@ int QMessageBox::information(QWidget *parent, const QString &title, const QStrin following values: \list - \o QMessageBox::NoButton - \o QMessageBox::Ok - \o QMessageBox::Cancel - \o QMessageBox::Yes - \o QMessageBox::No - \o QMessageBox::Abort - \o QMessageBox::Retry - \o QMessageBox::Ignore - \o QMessageBox::YesAll - \o QMessageBox::NoAll + \li QMessageBox::NoButton + \li QMessageBox::Ok + \li QMessageBox::Cancel + \li QMessageBox::Yes + \li QMessageBox::No + \li QMessageBox::Abort + \li QMessageBox::Retry + \li QMessageBox::Ignore + \li QMessageBox::YesAll + \li QMessageBox::NoAll \endlist If you don't want all three buttons, set the last button, or last @@ -2166,16 +2166,16 @@ int QMessageBox::question(QWidget *parent, const QString &title, const QString& one of the following values: \list - \o QMessageBox::NoButton - \o QMessageBox::Ok - \o QMessageBox::Cancel - \o QMessageBox::Yes - \o QMessageBox::No - \o QMessageBox::Abort - \o QMessageBox::Retry - \o QMessageBox::Ignore - \o QMessageBox::YesAll - \o QMessageBox::NoAll + \li QMessageBox::NoButton + \li QMessageBox::Ok + \li QMessageBox::Cancel + \li QMessageBox::Yes + \li QMessageBox::No + \li QMessageBox::Abort + \li QMessageBox::Retry + \li QMessageBox::Ignore + \li QMessageBox::YesAll + \li QMessageBox::NoAll \endlist If you don't want all three buttons, set the last button, or last @@ -2251,16 +2251,16 @@ int QMessageBox::warning(QWidget *parent, const QString &title, const QString& t one of the following values: \list - \o QMessageBox::NoButton - \o QMessageBox::Ok - \o QMessageBox::Cancel - \o QMessageBox::Yes - \o QMessageBox::No - \o QMessageBox::Abort - \o QMessageBox::Retry - \o QMessageBox::Ignore - \o QMessageBox::YesAll - \o QMessageBox::NoAll + \li QMessageBox::NoButton + \li QMessageBox::Ok + \li QMessageBox::Cancel + \li QMessageBox::Yes + \li QMessageBox::No + \li QMessageBox::Abort + \li QMessageBox::Retry + \li QMessageBox::Ignore + \li QMessageBox::YesAll + \li QMessageBox::NoAll \endlist If you don't want all three buttons, set the last button, or last diff --git a/src/widgets/dialogs/qprogressdialog.cpp b/src/widgets/dialogs/qprogressdialog.cpp index f39a7b63ec..350fb57e20 100644 --- a/src/widgets/dialogs/qprogressdialog.cpp +++ b/src/widgets/dialogs/qprogressdialog.cpp @@ -281,10 +281,10 @@ void QProgressDialogPrivate::_q_disconnectOnClose() Default settings: \list - \i The label text is empty. - \i The cancel button text is (translated) "Cancel". - \i minimum is 0; - \i maximum is 100 + \li The label text is empty. + \li The cancel button text is (translated) "Cancel". + \li minimum is 0; + \li maximum is 100 \endlist The \a parent argument is dialog's parent widget. The widget flags, \a f, are diff --git a/src/widgets/dialogs/qwizard.cpp b/src/widgets/dialogs/qwizard.cpp index 8cd3799cae..8a75353c86 100644 --- a/src/widgets/dialogs/qwizard.cpp +++ b/src/widgets/dialogs/qwizard.cpp @@ -1826,28 +1826,28 @@ void QWizardAntiFlickerWidget::paintEvent(QPaintEvent *) QWizard supports four wizard looks: \list - \o ClassicStyle - \o ModernStyle - \o MacStyle - \o AeroStyle + \li ClassicStyle + \li ModernStyle + \li MacStyle + \li AeroStyle \endlist You can explicitly set the look to use using setWizardStyle() (e.g., if you want the same look on all platforms). \table - \header \o ClassicStyle - \o ModernStyle - \o MacStyle - \o AeroStyle - \row \o \inlineimage qtwizard-classic1.png - \o \inlineimage qtwizard-modern1.png - \o \inlineimage qtwizard-mac1.png - \o \inlineimage qtwizard-aero1.png - \row \o \inlineimage qtwizard-classic2.png - \o \inlineimage qtwizard-modern2.png - \o \inlineimage qtwizard-mac2.png - \o \inlineimage qtwizard-aero2.png + \header \li ClassicStyle + \li ModernStyle + \li MacStyle + \li AeroStyle + \row \li \inlineimage qtwizard-classic1.png + \li \inlineimage qtwizard-modern1.png + \li \inlineimage qtwizard-mac1.png + \li \inlineimage qtwizard-aero1.png + \row \li \inlineimage qtwizard-classic2.png + \li \inlineimage qtwizard-modern2.png + \li \inlineimage qtwizard-mac2.png + \li \inlineimage qtwizard-aero2.png \endtable Note: AeroStyle has effect only on a Windows Vista system with alpha compositing enabled. @@ -1876,15 +1876,15 @@ void QWizardAntiFlickerWidget::paintEvent(QPaintEvent *) only one page is shown. A page has the following attributes: \list - \o A \l{QWizardPage::}{title}. - \o A \l{QWizardPage::}{subTitle}. - \o A set of pixmaps, which may or may not be honored, depending + \li A \l{QWizardPage::}{title}. + \li A \l{QWizardPage::}{subTitle}. + \li A set of pixmaps, which may or may not be honored, depending on the wizard's style: \list - \o WatermarkPixmap (used by ClassicStyle and ModernStyle) - \o BannerPixmap (used by ModernStyle) - \o LogoPixmap (used by ClassicStyle and ModernStyle) - \o BackgroundPixmap (used by MacStyle) + \li WatermarkPixmap (used by ClassicStyle and ModernStyle) + \li BannerPixmap (used by ModernStyle) + \li LogoPixmap (used by ClassicStyle and ModernStyle) + \li BackgroundPixmap (used by MacStyle) \endlist \endlist @@ -2590,9 +2590,9 @@ bool QWizard::testOption(WizardOption option) const By default, the following options are set (depending on the platform): \list - \o Windows: HelpButtonOnRight. - \o Mac OS X: NoDefaultButton and NoCancelButton. - \o X11 and QWS (Qt for Embedded Linux): none. + \li Windows: HelpButtonOnRight. + \li Mac OS X: NoDefaultButton and NoCancelButton. + \li X11 and QWS (Qt for Embedded Linux): none. \endlist \sa wizardStyle @@ -2881,14 +2881,14 @@ QPixmap QWizard::pixmap(WizardPixmap which) const changedSignal. The table below lists these widgets: \table - \header \o Widget \o Property \o Change Notification Signal - \row \o QAbstractButton \o bool \l{QAbstractButton::}{checked} \o \l{QAbstractButton::}{toggled()} - \row \o QAbstractSlider \o int \l{QAbstractSlider::}{value} \o \l{QAbstractSlider::}{valueChanged()} - \row \o QComboBox \o int \l{QComboBox::}{currentIndex} \o \l{QComboBox::}{currentIndexChanged()} - \row \o QDateTimeEdit \o QDateTime \l{QDateTimeEdit::}{dateTime} \o \l{QDateTimeEdit::}{dateTimeChanged()} - \row \o QLineEdit \o QString \l{QLineEdit::}{text} \o \l{QLineEdit::}{textChanged()} - \row \o QListWidget \o int \l{QListWidget::}{currentRow} \o \l{QListWidget::}{currentRowChanged()} - \row \o QSpinBox \o int \l{QSpinBox::}{value} \o \l{QSpinBox::}{valueChanged()} + \header \li Widget \li Property \li Change Notification Signal + \row \li QAbstractButton \li bool \l{QAbstractButton::}{checked} \li \l{QAbstractButton::}{toggled()} + \row \li QAbstractSlider \li int \l{QAbstractSlider::}{value} \li \l{QAbstractSlider::}{valueChanged()} + \row \li QComboBox \li int \l{QComboBox::}{currentIndex} \li \l{QComboBox::}{currentIndexChanged()} + \row \li QDateTimeEdit \li QDateTime \l{QDateTimeEdit::}{dateTime} \li \l{QDateTimeEdit::}{dateTimeChanged()} + \row \li QLineEdit \li QString \l{QLineEdit::}{text} \li \l{QLineEdit::}{textChanged()} + \row \li QListWidget \li int \l{QListWidget::}{currentRow} \li \l{QListWidget::}{currentRowChanged()} + \row \li QSpinBox \li int \l{QSpinBox::}{value} \li \l{QSpinBox::}{valueChanged()} \endtable \sa QWizardPage::registerField() @@ -3361,19 +3361,19 @@ int QWizard::nextId() const provide custom behavior: \list - \o initializePage() is called to initialize the page's contents + \li initializePage() is called to initialize the page's contents when the user clicks the wizard's \gui Next button. If you want to derive the page's default from what the user entered on previous pages, this is the function to reimplement. - \o cleanupPage() is called to reset the page's contents when the + \li cleanupPage() is called to reset the page's contents when the user clicks the wizard's \gui Back button. - \o validatePage() validates the page when the user clicks \gui + \li validatePage() validates the page when the user clicks \gui Next or \gui Finish. It is often used to show an error message if the user has entered incomplete or invalid information. - \o nextId() returns the ID of the next page. It is useful when + \li nextId() returns the ID of the next page. It is useful when \l{creating non-linear wizards}, which allow different traversal paths based on the information provided by the user. - \o isComplete() is called to determine whether the \gui Next + \li isComplete() is called to determine whether the \gui Next and/or \gui Finish button should be enabled or disabled. If you reimplement isComplete(), also make sure that completeChanged() is emitted whenever the complete state @@ -3878,14 +3878,14 @@ QVariant QWizardPage::field(const QString &name) const changedSignal. The table below lists these widgets: \table - \header \o Widget \o Property \o Change Notification Signal - \row \o QAbstractButton \o bool \l{QAbstractButton::}{checked} \o \l{QAbstractButton::}{toggled()} - \row \o QAbstractSlider \o int \l{QAbstractSlider::}{value} \o \l{QAbstractSlider::}{valueChanged()} - \row \o QComboBox \o int \l{QComboBox::}{currentIndex} \o \l{QComboBox::}{currentIndexChanged()} - \row \o QDateTimeEdit \o QDateTime \l{QDateTimeEdit::}{dateTime} \o \l{QDateTimeEdit::}{dateTimeChanged()} - \row \o QLineEdit \o QString \l{QLineEdit::}{text} \o \l{QLineEdit::}{textChanged()} - \row \o QListWidget \o int \l{QListWidget::}{currentRow} \o \l{QListWidget::}{currentRowChanged()} - \row \o QSpinBox \o int \l{QSpinBox::}{value} \o \l{QSpinBox::}{valueChanged()} + \header \li Widget \li Property \li Change Notification Signal + \row \li QAbstractButton \li bool \l{QAbstractButton::}{checked} \li \l{QAbstractButton::}{toggled()} + \row \li QAbstractSlider \li int \l{QAbstractSlider::}{value} \li \l{QAbstractSlider::}{valueChanged()} + \row \li QComboBox \li int \l{QComboBox::}{currentIndex} \li \l{QComboBox::}{currentIndexChanged()} + \row \li QDateTimeEdit \li QDateTime \l{QDateTimeEdit::}{dateTime} \li \l{QDateTimeEdit::}{dateTimeChanged()} + \row \li QLineEdit \li QString \l{QLineEdit::}{text} \li \l{QLineEdit::}{textChanged()} + \row \li QListWidget \li int \l{QListWidget::}{currentRow} \li \l{QListWidget::}{currentRowChanged()} + \row \li QSpinBox \li int \l{QSpinBox::}{value} \li \l{QSpinBox::}{valueChanged()} \endtable You can use QWizard::setDefaultProperty() to add entries to this diff --git a/src/widgets/effects/qgraphicseffect.cpp b/src/widgets/effects/qgraphicseffect.cpp index f1b4cc80f9..80c0aff492 100644 --- a/src/widgets/effects/qgraphicseffect.cpp +++ b/src/widgets/effects/qgraphicseffect.cpp @@ -62,21 +62,21 @@ Qt provides the following standard effects: \list - \o QGraphicsBlurEffect - blurs the item by a given radius - \o QGraphicsDropShadowEffect - renders a dropshadow behind the item - \o QGraphicsColorizeEffect - renders the item in shades of any given color - \o QGraphicsOpacityEffect - renders the item with an opacity + \li QGraphicsBlurEffect - blurs the item by a given radius + \li QGraphicsDropShadowEffect - renders a dropshadow behind the item + \li QGraphicsColorizeEffect - renders the item in shades of any given color + \li QGraphicsOpacityEffect - renders the item with an opacity \endlist \table \row - \o{2,1} \img graphicseffect-plain.png + \li{2,1} \img graphicseffect-plain.png \row - \o \img graphicseffect-blur.png - \o \img graphicseffect-colorize.png + \li \img graphicseffect-blur.png + \li \img graphicseffect-colorize.png \row - \o \img graphicseffect-opacity.png - \o \img graphicseffect-drop-shadow.png + \li \img graphicseffect-opacity.png + \li \img graphicseffect-drop-shadow.png \endtable \img graphicseffect-widget.png diff --git a/src/widgets/graphicsview/qgraphicsanchorlayout.cpp b/src/widgets/graphicsview/qgraphicsanchorlayout.cpp index 1ccf6fcffe..348d8f2d09 100644 --- a/src/widgets/graphicsview/qgraphicsanchorlayout.cpp +++ b/src/widgets/graphicsview/qgraphicsanchorlayout.cpp @@ -107,11 +107,11 @@ avoid any future regressions in behaviour: \list - \o Stretch factors are not respected. + \li Stretch factors are not respected. - \o QSizePolicy::ExpandFlag is not respected. + \li QSizePolicy::ExpandFlag is not respected. - \o Height for width is not respected. + \li Height for width is not respected. \endlist diff --git a/src/widgets/graphicsview/qgraphicsitem.cpp b/src/widgets/graphicsview/qgraphicsitem.cpp index ab03ff7a9e..d88183fbb5 100644 --- a/src/widgets/graphicsview/qgraphicsitem.cpp +++ b/src/widgets/graphicsview/qgraphicsitem.cpp @@ -59,14 +59,14 @@ common shapes. These are: \list - \o QGraphicsEllipseItem provides an ellipse item - \o QGraphicsLineItem provides a line item - \o QGraphicsPathItem provides an arbitrary path item - \o QGraphicsPixmapItem provides a pixmap item - \o QGraphicsPolygonItem provides a polygon item - \o QGraphicsRectItem provides a rectangular item - \o QGraphicsSimpleTextItem provides a simple text label item - \o QGraphicsTextItem provides an advanced text browser item + \li QGraphicsEllipseItem provides an ellipse item + \li QGraphicsLineItem provides a line item + \li QGraphicsPathItem provides an arbitrary path item + \li QGraphicsPixmapItem provides a pixmap item + \li QGraphicsPolygonItem provides a polygon item + \li QGraphicsRectItem provides a rectangular item + \li QGraphicsSimpleTextItem provides a simple text label item + \li QGraphicsTextItem provides an advanced text browser item \endlist All of an item's geometric information is based on its local coordinate @@ -112,12 +112,12 @@ \list 1 - \o Reimplement shape() to return an accurate shape for your item, + \li Reimplement shape() to return an accurate shape for your item, and rely on the default implementation of collidesWithItem() to do shape-shape intersection. This can be rather expensive if the shapes are complex. - \o Reimplement collidesWithItem() to provide your own custom item + \li Reimplement collidesWithItem() to provide your own custom item and shape collision algorithm. \endlist @@ -165,10 +165,10 @@ QGraphicsItem always applies the properties in a fixed, defined order: \list - \o The item's base transform is applied (transform()) - \o The item's transformations list is applied in order (transformations()) - \o The item is rotated relative to its transform origin point (rotation(), transformOriginPoint()) - \o The item is scaled relative to its transform origin point (scale(), transformOriginPoint()) + \li The item's base transform is applied (transform()) + \li The item's transformations list is applied in order (transformations()) + \li The item is rotated relative to its transform origin point (rotation(), transformOriginPoint()) + \li The item is scaled relative to its transform origin point (scale(), transformOriginPoint()) \endlist \section1 Painting @@ -215,14 +215,14 @@ For advanced users, there are ways to alter how your items are sorted: \list - \o You can call setZValue() on an item to explicitly stack it on top of, or + \li You can call setZValue() on an item to explicitly stack it on top of, or under, other sibling items. The default Z value for an item is 0. Items with the same Z value are stacked by insertion order. - \o You can call stackBefore() to reorder the list of children. This will + \li You can call stackBefore() to reorder the list of children. This will directly modify the insertion order. - \o You can set the ItemStacksBehindParent flag to stack a child item behind + \li You can set the ItemStacksBehindParent flag to stack a child item behind its parent. \endlist @@ -238,13 +238,13 @@ to a set of convenience event handlers: \list - \o contextMenuEvent() handles context menu events - \o focusInEvent() and focusOutEvent() handle focus in and out events - \o hoverEnterEvent(), hoverMoveEvent(), and hoverLeaveEvent() handles + \li contextMenuEvent() handles context menu events + \li focusInEvent() and focusOutEvent() handle focus in and out events + \li hoverEnterEvent(), hoverMoveEvent(), and hoverLeaveEvent() handles hover enter, move and leave events - \o inputMethodEvent() handles input events, for accessibility support - \o keyPressEvent() and keyReleaseEvent() handle key press and release events - \o mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent(), and + \li inputMethodEvent() handles input events, for accessibility support + \li keyPressEvent() and keyReleaseEvent() handle key press and release events + \li mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent(), and mouseDoubleClickEvent() handles mouse press, move, release, click and doubleclick events \endlist @@ -3469,11 +3469,11 @@ QGraphicsItem *QGraphicsItem::focusScopeItem() const following events occurs: \list - \o The item becomes invisible - \o The item is removed from the scene - \o The item is deleted - \o The item call ungrabMouse() - \o Another item calls grabMouse(); the item will regain the mouse grab + \li The item becomes invisible + \li The item is removed from the scene + \li The item is deleted + \li The item call ungrabMouse() + \li Another item calls grabMouse(); the item will regain the mouse grab when the other item calls ungrabMouse(). \endlist @@ -3531,11 +3531,11 @@ void QGraphicsItem::ungrabMouse() following events occur: \list - \o The item becomes invisible - \o The item is removed from the scene - \o The item is deleted - \o The item calls ungrabKeyboard() - \o Another item calls grabKeyboard(); the item will regain the keyboard grab + \li The item becomes invisible + \li The item is removed from the scene + \li The item is deleted + \li The item calls ungrabKeyboard() + \li Another item calls grabKeyboard(); the item will regain the keyboard grab when the other item calls ungrabKeyboard(). \endlist @@ -5730,7 +5730,7 @@ void QGraphicsItem::update(const QRectF &rect) viewport, which does not benefit from scroll optimizations), this function is equivalent to calling update(\a rect). - \bold{Note:} Scrolling is only supported when QGraphicsItem::ItemCoordinateCache + \b{Note:} Scrolling is only supported when QGraphicsItem::ItemCoordinateCache is enabled; in all other cases calling this function is equivalent to calling update(\a rect). If you for sure know that the item is opaque and not overlapped by other items, you can map the \a rect to viewport coordinates and scroll the @@ -8652,8 +8652,8 @@ QVariant QGraphicsRectItem::extension(const QVariant &variant) const \table \row - \o \inlineimage graphicsview-ellipseitem.png - \o \inlineimage graphicsview-ellipseitem-pie.png + \li \inlineimage graphicsview-ellipseitem.png + \li \inlineimage graphicsview-ellipseitem-pie.png \endtable To set the item's ellipse, pass a QRectF to QGraphicsEllipseItem's diff --git a/src/widgets/graphicsview/qgraphicslayout.cpp b/src/widgets/graphicsview/qgraphicslayout.cpp index 63f04f67bc..6f93dd511d 100644 --- a/src/widgets/graphicsview/qgraphicslayout.cpp +++ b/src/widgets/graphicsview/qgraphicslayout.cpp @@ -77,19 +77,19 @@ QT_BEGIN_NAMESPACE minimum: \table - \header \o Function \o Description - \row \o QGraphicsLayoutItem::setGeometry() - \o Notifies you when the geometry of the layout is set. You can + \header \li Function \li Description + \row \li QGraphicsLayoutItem::setGeometry() + \li Notifies you when the geometry of the layout is set. You can store the geometry in your own layout class in a reimplementation of this function. - \row \o QGraphicsLayoutItem::sizeHint() - \o Returns the layout's size hints. - \row \o QGraphicsLayout::count() - \o Returns the number of items in your layout. - \row \o QGraphicsLayout::itemAt() - \o Returns a pointer to an item in your layout. - \row \o QGraphicsLayout::removeAt() - \o Removes an item from your layout without destroying it. + \row \li QGraphicsLayoutItem::sizeHint() + \li Returns the layout's size hints. + \row \li QGraphicsLayout::count() + \li Returns the number of items in your layout. + \row \li QGraphicsLayout::itemAt() + \li Returns a pointer to an item in your layout. + \row \li QGraphicsLayout::removeAt() + \li Removes an item from your layout without destroying it. \endtable For more details on how to implement each function, refer to the individual diff --git a/src/widgets/graphicsview/qgraphicsproxywidget.cpp b/src/widgets/graphicsview/qgraphicsproxywidget.cpp index d532c4e541..4cda3e51fb 100644 --- a/src/widgets/graphicsview/qgraphicsproxywidget.cpp +++ b/src/widgets/graphicsview/qgraphicsproxywidget.cpp @@ -136,45 +136,45 @@ QT_BEGIN_NAMESPACE QGraphicsProxyWidget maintains symmetry for the following states: \table - \header \o QWidget state \o QGraphicsProxyWidget state \o Notes - \row \o QWidget::enabled - \o QGraphicsProxyWidget::enabled - \o - \row \o QWidget::visible - \o QGraphicsProxyWidget::visible - \o The explicit state is also symmetric. - \row \o QWidget::geometry - \o QGraphicsProxyWidget::geometry - \o Geometry is only guaranteed to be symmetric while + \header \li QWidget state \li QGraphicsProxyWidget state \li Notes + \row \li QWidget::enabled + \li QGraphicsProxyWidget::enabled + \li + \row \li QWidget::visible + \li QGraphicsProxyWidget::visible + \li The explicit state is also symmetric. + \row \li QWidget::geometry + \li QGraphicsProxyWidget::geometry + \li Geometry is only guaranteed to be symmetric while the embedded widget is visible. - \row \o QWidget::layoutDirection - \o QGraphicsProxyWidget::layoutDirection - \o - \row \o QWidget::style - \o QGraphicsProxyWidget::style - \o - \row \o QWidget::palette - \o QGraphicsProxyWidget::palette - \o - \row \o QWidget::font - \o QGraphicsProxyWidget::font - \o - \row \o QWidget::cursor - \o QGraphicsProxyWidget::cursor - \o The embedded widget overrides the proxy widget + \row \li QWidget::layoutDirection + \li QGraphicsProxyWidget::layoutDirection + \li + \row \li QWidget::style + \li QGraphicsProxyWidget::style + \li + \row \li QWidget::palette + \li QGraphicsProxyWidget::palette + \li + \row \li QWidget::font + \li QGraphicsProxyWidget::font + \li + \row \li QWidget::cursor + \li QGraphicsProxyWidget::cursor + \li The embedded widget overrides the proxy widget cursor. The proxy cursor changes depending on which embedded subwidget is currently under the mouse. - \row \o QWidget::sizeHint() - \o QGraphicsProxyWidget::sizeHint() - \o All size hint functionality from the embedded + \row \li QWidget::sizeHint() + \li QGraphicsProxyWidget::sizeHint() + \li All size hint functionality from the embedded widget is forwarded by the proxy. - \row \o QWidget::getContentsMargins() - \o QGraphicsProxyWidget::getContentsMargins() - \o Updated once by setWidget(). - \row \o QWidget::windowTitle - \o QGraphicsProxyWidget::windowTitle - \o Updated once by setWidget(). + \row \li QWidget::getContentsMargins() + \li QGraphicsProxyWidget::getContentsMargins() + \li Updated once by setWidget(). + \row \li QWidget::windowTitle + \li QGraphicsProxyWidget::windowTitle + \li Updated once by setWidget(). \endtable \note QGraphicsScene keeps the embedded widget in a special state that diff --git a/src/widgets/graphicsview/qgraphicsscene.cpp b/src/widgets/graphicsview/qgraphicsscene.cpp index 51d86dadb1..015cd254d4 100644 --- a/src/widgets/graphicsview/qgraphicsscene.cpp +++ b/src/widgets/graphicsview/qgraphicsscene.cpp @@ -3118,12 +3118,12 @@ bool QGraphicsScene::stickyFocus() const the following events occur: \list - \o If the item receives a mouse release event when there are no other + \li If the item receives a mouse release event when there are no other buttons pressed, it loses the mouse grab. - \o If the item becomes invisible (i.e., someone calls \c {item->setVisible(false)}), + \li If the item becomes invisible (i.e., someone calls \c {item->setVisible(false)}), or if it becomes disabled (i.e., someone calls \c {item->setEnabled(false)}), it loses the mouse grab. - \o If the item is removed from the scene, it loses the mouse grab. + \li If the item is removed from the scene, it loses the mouse grab. \endlist If the item loses its mouse grab, the scene will ignore all mouse events diff --git a/src/widgets/graphicsview/qgraphicswidget.cpp b/src/widgets/graphicsview/qgraphicswidget.cpp index c179aeff2b..da4ccb1a33 100644 --- a/src/widgets/graphicsview/qgraphicswidget.cpp +++ b/src/widgets/graphicsview/qgraphicswidget.cpp @@ -81,10 +81,10 @@ QT_BEGIN_NAMESPACE over QGraphicsItem. It is similar to QWidget in many ways: \list - \o Provides a \l palette, a \l font and a \l style(). - \o Has a defined geometry(). - \o Supports layouts with setLayout() and layout(). - \o Supports shortcuts and actions with grabShortcut() and insertAction() + \li Provides a \l palette, a \l font and a \l style(). + \li Has a defined geometry(). + \li Supports layouts with setLayout() and layout(). + \li Supports shortcuts and actions with grabShortcut() and insertAction() \endlist Unlike QGraphicsItem, QGraphicsWidget is not an abstract class; you can @@ -106,23 +106,23 @@ QT_BEGIN_NAMESPACE Noticeable differences between QGraphicsWidget and QWidget are: \table - \header \o QGraphicsWidget - \o QWidget - \row \o Coordinates and geometry are defined with qreals (doubles or + \header \li QGraphicsWidget + \li QWidget + \row \li Coordinates and geometry are defined with qreals (doubles or floats, depending on the platform). - \o QWidget uses integer geometry (QPoint, QRect). - \row \o The widget is already visible by default; you do not have to + \li QWidget uses integer geometry (QPoint, QRect). + \row \li The widget is already visible by default; you do not have to call show() to display the widget. - \o QWidget is hidden by default until you call show(). - \row \o A subset of widget attributes are supported. - \o All widget attributes are supported. - \row \o A top-level item's style defaults to QGraphicsScene::style - \o A top-level widget's style defaults to QApplication::style - \row \o Graphics View provides a custom drag and drop framework, different + \li QWidget is hidden by default until you call show(). + \row \li A subset of widget attributes are supported. + \li All widget attributes are supported. + \row \li A top-level item's style defaults to QGraphicsScene::style + \li A top-level widget's style defaults to QApplication::style + \row \li Graphics View provides a custom drag and drop framework, different from QWidget. - \o Standard drag and drop framework. - \row \o Widget items do not support modality. - \o Full modality support. + \li Standard drag and drop framework. + \row \li Widget items do not support modality. + \li Full modality support. \endtable QGraphicsWidget supports a subset of Qt's widget attributes, @@ -130,32 +130,32 @@ QT_BEGIN_NAMESPACE listed in this table are unsupported, or otherwise unused. \table - \header \o Widget Attribute \o Usage - \row \o Qt::WA_SetLayoutDirection - \o Set by setLayoutDirection(), cleared by + \header \li Widget Attribute \li Usage + \row \li Qt::WA_SetLayoutDirection + \li Set by setLayoutDirection(), cleared by unsetLayoutDirection(). You can test this attribute to check if the widget has been explicitly assigned a \l{QGraphicsWidget::layoutDirection()} {layoutDirection}. If the attribute is not set, the \l{QGraphicsWidget::layoutDirection()} {layoutDirection()} is inherited. - \row \o Qt::WA_RightToLeft - \o Toggled by setLayoutDirection(). Inherited from the + \row \li Qt::WA_RightToLeft + \li Toggled by setLayoutDirection(). Inherited from the parent/scene. If set, the widget's layout will order horizontally arranged widgets from right to left. - \row \o Qt::WA_SetStyle - \o Set and cleared by setStyle(). If this attribute is + \row \li Qt::WA_SetStyle + \li Set and cleared by setStyle(). If this attribute is set, the widget has been explicitly assigned a style. If it is unset, the widget will use the scene's or the application's style. - \row \o Qt::WA_Resized - \o Set by setGeometry() and resize(). - \row \o Qt::WA_SetPalette - \o Set by setPalette(). - \row \o Qt::WA_SetFont - \o Set by setFont(). - \row \o Qt::WA_WindowPropagation - \o Enables propagation to window widgets. + \row \li Qt::WA_Resized + \li Set by setGeometry() and resize(). + \row \li Qt::WA_SetPalette + \li Set by setPalette(). + \row \li Qt::WA_SetFont + \li Set by setFont(). + \row \li Qt::WA_WindowPropagation + \li Enables propagation to window widgets. \endtable Although QGraphicsWidget inherits from both QObject and QGraphicsItem, @@ -646,29 +646,29 @@ QRectF QGraphicsWidget::windowFrameRect() const \table \header - \o Style Option Property - \o Value + \li Style Option Property + \li Value \row - \o state & QStyle::State_Enabled - \o Corresponds to QGraphicsItem::isEnabled(). + \li state & QStyle::State_Enabled + \li Corresponds to QGraphicsItem::isEnabled(). \row - \o state & QStyle::State_HasFocus - \o Corresponds to QGraphicsItem::hasFocus(). + \li state & QStyle::State_HasFocus + \li Corresponds to QGraphicsItem::hasFocus(). \row - \o state & QStyle::State_MouseOver - \o Corresponds to QGraphicsItem::isUnderMouse(). + \li state & QStyle::State_MouseOver + \li Corresponds to QGraphicsItem::isUnderMouse(). \row - \o direction - \o Corresponds to QGraphicsWidget::layoutDirection(). + \li direction + \li Corresponds to QGraphicsWidget::layoutDirection(). \row - \o rect - \o Corresponds to QGraphicsWidget::rect().toRect(). + \li rect + \li Corresponds to QGraphicsWidget::rect().toRect(). \row - \o palette - \o Corresponds to QGraphicsWidget::palette(). + \li palette + \li Corresponds to QGraphicsWidget::palette(). \row - \o fontMetrics - \o Corresponds to QFontMetrics(QGraphicsWidget::font()). + \li fontMetrics + \li Corresponds to QFontMetrics(QGraphicsWidget::font()). \endtable Subclasses of QGraphicsWidget should call the base implementation, and @@ -1201,11 +1201,11 @@ QVariant QGraphicsWidget::itemChange(GraphicsItemChange change, const QVariant & QGraphicsWidget delivers notifications for the following properties: - \table \o propertyName \o Property - \row \o layoutDirection \o QGraphicsWidget::layoutDirection - \row \o size \o QGraphicsWidget::size - \row \o font \o QGraphicsWidget::font - \row \o palette \o QGraphicsWidget::palette + \table \li propertyName \li Property + \row \li layoutDirection \li QGraphicsWidget::layoutDirection + \row \li size \li QGraphicsWidget::size + \row \li font \li QGraphicsWidget::font + \row \li palette \li QGraphicsWidget::palette \endtable \sa itemChange() @@ -1347,33 +1347,33 @@ Qt::WindowFrameSection QGraphicsWidget::windowFrameSectionAt(const QPointF &pos) Handles the \a event. QGraphicsWidget handles the following events: - \table \o Event \o Usage - \row \o Polish - \o Delivered to the widget some time after it has been + \table \li Event \li Usage + \row \li Polish + \li Delivered to the widget some time after it has been shown. - \row \o GraphicsSceneMove - \o Delivered to the widget after its local position has + \row \li GraphicsSceneMove + \li Delivered to the widget after its local position has changed. - \row \o GraphicsSceneResize - \o Delivered to the widget after its size has changed. - \row \o Show - \o Delivered to the widget before it has been shown. - \row \o Hide - \o Delivered to the widget after it has been hidden. - \row \o PaletteChange - \o Delivered to the widget after its palette has changed. - \row \o FontChange - \o Delivered to the widget after its font has changed. - \row \o EnabledChange - \o Delivered to the widget after its enabled state has + \row \li GraphicsSceneResize + \li Delivered to the widget after its size has changed. + \row \li Show + \li Delivered to the widget before it has been shown. + \row \li Hide + \li Delivered to the widget after it has been hidden. + \row \li PaletteChange + \li Delivered to the widget after its palette has changed. + \row \li FontChange + \li Delivered to the widget after its font has changed. + \row \li EnabledChange + \li Delivered to the widget after its enabled state has changed. - \row \o StyleChange - \o Delivered to the widget after its style has changed. - \row \o LayoutDirectionChange - \o Delivered to the widget after its layout direction has + \row \li StyleChange + \li Delivered to the widget after its style has changed. + \row \li LayoutDirectionChange + \li Delivered to the widget after its layout direction has changed. - \row \o ContentsRectChange - \o Delivered to the widget after its contents margins/ + \row \li ContentsRectChange + \li Delivered to the widget after its contents margins/ contents rect has changed. \endtable */ diff --git a/src/widgets/itemviews/qabstractitemview.cpp b/src/widgets/itemviews/qabstractitemview.cpp index ff3de308e5..8530e2c23e 100644 --- a/src/widgets/itemviews/qabstractitemview.cpp +++ b/src/widgets/itemviews/qabstractitemview.cpp @@ -251,34 +251,34 @@ void QAbstractItemViewPrivate::_q_scrollerStateChanged() \table \header - \o Keys - \o Functionality + \li Keys + \li Functionality \row - \o Arrow keys - \o Changes the current item and selects it. + \li Arrow keys + \li Changes the current item and selects it. \row - \o Ctrl+Arrow keys - \o Changes the current item but does not select it. + \li Ctrl+Arrow keys + \li Changes the current item but does not select it. \row - \o Shift+Arrow keys - \o Changes the current item and selects it. The previously + \li Shift+Arrow keys + \li Changes the current item and selects it. The previously selected item(s) is not deselected. \row - \o Ctr+Space - \o Toggles selection of the current item. + \li Ctr+Space + \li Toggles selection of the current item. \row - \o Tab/Backtab - \o Changes the current item to the next/previous item. + \li Tab/Backtab + \li Changes the current item to the next/previous item. \row - \o Home/End - \o Selects the first/last item in the model. + \li Home/End + \li Selects the first/last item in the model. \row - \o Page up/Page down - \o Scrolls the rows shown up/down by the number of + \li Page up/Page down + \li Scrolls the rows shown up/down by the number of visible rows in the view. \row - \o Ctrl+A - \o Selects all items in the model. + \li Ctrl+A + \li Selects all items in the model. \endtable Note that the above table assumes that the @@ -1428,7 +1428,7 @@ bool QAbstractItemView::dragEnabled() const \value DragOnly The view supports dragging of its own items \value DropOnly The view accepts drops \value DragDrop The view supports both dragging and dropping - \value InternalMove The view accepts move (\bold{not copy}) operations only + \value InternalMove The view accepts move (\b{not copy}) operations only from itself. Note that the model used needs to provide support for drag and drop operations. diff --git a/src/widgets/itemviews/qdatawidgetmapper.cpp b/src/widgets/itemviews/qdatawidgetmapper.cpp index e4eca4287b..2f7b1f7ecb 100644 --- a/src/widgets/itemviews/qdatawidgetmapper.cpp +++ b/src/widgets/itemviews/qdatawidgetmapper.cpp @@ -279,11 +279,11 @@ void QDataWidgetMapperPrivate::_q_modelDestroyed() Let us assume that we have an item model named \c{model} with the following contents: \table - \row \o 1 \o Qt Norway \o Oslo - \row \o 2 \o Qt Australia \o Brisbane - \row \o 3 \o Qt USA \o Palo Alto - \row \o 4 \o Qt China \o Beijing - \row \o 5 \o Qt Germany \o Berlin + \row \li 1 \li Qt Norway \li Oslo + \row \li 2 \li Qt Australia \li Brisbane + \row \li 3 \li Qt USA \li Palo Alto + \row \li 4 \li Qt China \li Beijing + \row \li 5 \li Qt Germany \li Berlin \endtable The following code will map the columns of the model to widgets called \c mySpinBox, @@ -478,11 +478,11 @@ QModelIndex QDataWidgetMapper::rootIndex() const \snippet doc/src/snippets/code/src_gui_itemviews_qdatawidgetmapper.cpp 1 - \bold{Notes:} + \b{Notes:} \list - \o If the \a widget is already mapped to a section, the + \li If the \a widget is already mapped to a section, the old mapping will be replaced by the new one. - \o Only one-to-one mappings between sections and widgets are allowed. + \li Only one-to-one mappings between sections and widgets are allowed. It is not possible to map a single section to multiple widgets, or to map a single widget to multiple sections. \endlist @@ -781,11 +781,11 @@ void QDataWidgetMapper::clearMapping() Use Qt::Horizontal for tabular data that looks like this: \table - \row \o 1 \o Qt Norway \o Oslo - \row \o 2 \o Qt Australia \o Brisbane - \row \o 3 \o Qt USA \o Silicon Valley - \row \o 4 \o Qt China \o Beijing - \row \o 5 \o Qt Germany \o Berlin + \row \li 1 \li Qt Norway \li Oslo + \row \li 2 \li Qt Australia \li Brisbane + \row \li 3 \li Qt USA \li Silicon Valley + \row \li 4 \li Qt China \li Beijing + \row \li 5 \li Qt Germany \li Berlin \endtable If the orientation is set to Qt::Vertical, a widget is mapped to @@ -796,9 +796,9 @@ void QDataWidgetMapper::clearMapping() Use Qt::Vertical for tabular data that looks like this: \table - \row \o 1 \o 2 \o 3 \o 4 \o 5 - \row \o Qt Norway \o Qt Australia \o Qt USA \o Qt China \o Qt Germany - \row \o Oslo \o Brisbane \o Silicon Valley \o Beijing \i Berlin + \row \li 1 \li 2 \li 3 \li 4 \li 5 + \row \li Qt Norway \li Qt Australia \li Qt USA \li Qt China \li Qt Germany + \row \li Oslo \li Brisbane \li Silicon Valley \li Beijing \li Berlin \endtable Changing the orientation clears all existing mappings. diff --git a/src/widgets/itemviews/qdirmodel.cpp b/src/widgets/itemviews/qdirmodel.cpp index ee097e5c41..490c272e39 100644 --- a/src/widgets/itemviews/qdirmodel.cpp +++ b/src/widgets/itemviews/qdirmodel.cpp @@ -1011,12 +1011,12 @@ QModelIndex QDirModel::mkdir(const QModelIndex &parent, const QString &name) /*! Removes the directory corresponding to the model item \a index in the - directory model and \bold{deletes the corresponding directory from the + directory model and \b{deletes the corresponding directory from the file system}, returning true if successful. If the directory cannot be removed, false is returned. \warning This function deletes directories from the file system; it does - \bold{not} move them to a location where they can be recovered. + \b{not} move them to a location where they can be recovered. \sa remove() */ @@ -1046,11 +1046,11 @@ bool QDirModel::rmdir(const QModelIndex &index) } /*! - Removes the model item \a index from the directory model and \bold{deletes the + Removes the model item \a index from the directory model and \b{deletes the corresponding file from the file system}, returning true if successful. If the item cannot be removed, false is returned. - \warning This function deletes files from the file system; it does \bold{not} + \warning This function deletes files from the file system; it does \b{not} move them to a location where they can be recovered. \sa rmdir() @@ -1134,7 +1134,7 @@ QIcon QDirModel::fileIcon(const QModelIndex &index) const /*! Returns the file information for the specified model \a index. - \bold{Note:} If the model index represents a symbolic link in the + \b{Note:} If the model index represents a symbolic link in the underlying filing system, the file information returned will contain information about the symbolic link itself, regardless of whether resolveSymlinks is enabled or not. diff --git a/src/widgets/itemviews/qitemdelegate.cpp b/src/widgets/itemviews/qitemdelegate.cpp index feec3fcbc5..419c62ff65 100644 --- a/src/widgets/itemviews/qitemdelegate.cpp +++ b/src/widgets/itemviews/qitemdelegate.cpp @@ -231,12 +231,12 @@ QSizeF QItemDelegatePrivate::doTextLayout(int lineWidth) const reimplemented here: \list - \o createEditor() returns the widget used to change data from the model + \li createEditor() returns the widget used to change data from the model and can be reimplemented to customize editing behavior. - \o setEditorData() provides the widget with data to manipulate. - \o updateEditorGeometry() ensures that the editor is displayed correctly + \li setEditorData() provides the widget with data to manipulate. + \li updateEditorGeometry() ensures that the editor is displayed correctly with respect to the item view. - \o setModelData() returns updated data to the model. + \li setModelData() returns updated data to the model. \endlist The closeEditor() signal indicates that the user has completed editing the data, @@ -250,28 +250,28 @@ QSizeF QItemDelegatePrivate::doTextLayout(int lineWidth) const appearance of the delegate as described in the following table. \table - \header \o Role \o Accepted Types + \header \li Role \li Accepted Types \omit - \row \o \l Qt::AccessibleDescriptionRole \o QString - \row \o \l Qt::AccessibleTextRole \o QString + \row \li \l Qt::AccessibleDescriptionRole \li QString + \row \li \l Qt::AccessibleTextRole \li QString \endomit - \row \o \l Qt::BackgroundRole \o QBrush - \row \o \l Qt::BackgroundColorRole \o QColor (obsolete; use Qt::BackgroundRole instead) - \row \o \l Qt::CheckStateRole \o Qt::CheckState - \row \o \l Qt::DecorationRole \o QIcon, QPixmap and QColor - \row \o \l Qt::DisplayRole \o QString and types with a string representation - \row \o \l Qt::EditRole \o See QItemEditorFactory for details - \row \o \l Qt::FontRole \o QFont - \row \o \l Qt::SizeHintRole \o QSize + \row \li \l Qt::BackgroundRole \li QBrush + \row \li \l Qt::BackgroundColorRole \li QColor (obsolete; use Qt::BackgroundRole instead) + \row \li \l Qt::CheckStateRole \li Qt::CheckState + \row \li \l Qt::DecorationRole \li QIcon, QPixmap and QColor + \row \li \l Qt::DisplayRole \li QString and types with a string representation + \row \li \l Qt::EditRole \li See QItemEditorFactory for details + \row \li \l Qt::FontRole \li QFont + \row \li \l Qt::SizeHintRole \li QSize \omit - \row \o \l Qt::StatusTipRole \o + \row \li \l Qt::StatusTipRole \li \endomit - \row \o \l Qt::TextAlignmentRole \o Qt::Alignment - \row \o \l Qt::ForegroundRole \o QBrush - \row \o \l Qt::TextColorRole \o QColor (obsolete; use Qt::ForegroundRole instead) + \row \li \l Qt::TextAlignmentRole \li Qt::Alignment + \row \li \l Qt::ForegroundRole \li QBrush + \row \li \l Qt::TextColorRole \li QColor (obsolete; use Qt::ForegroundRole instead) \omit - \row \o \l Qt::ToolTipRole - \row \o \l Qt::WhatsThisRole + \row \li \l Qt::ToolTipRole + \row \li \l Qt::WhatsThisRole \endomit \endtable @@ -1152,11 +1152,11 @@ QRect QItemDelegate::textRectangle(QPainter * /*painter*/, const QRect &rect, key press events are handled by default: \list - \o \gui Tab - \o \gui Backtab - \o \gui Enter - \o \gui Return - \o \gui Esc + \li \gui Tab + \li \gui Backtab + \li \gui Enter + \li \gui Return + \li \gui Esc \endlist In the case of \gui Tab, \gui Backtab, \gui Enter and \gui Return diff --git a/src/widgets/itemviews/qitemeditorfactory.cpp b/src/widgets/itemviews/qitemeditorfactory.cpp index 468929a554..b4180c18dd 100644 --- a/src/widgets/itemviews/qitemeditorfactory.cpp +++ b/src/widgets/itemviews/qitemeditorfactory.cpp @@ -102,16 +102,16 @@ public: types and the standard editors provided. \table - \header \o Type \o Editor Widget - \row \o bool \o QComboBox - \row \o double \o QDoubleSpinBox - \row \o int \o{1,2} QSpinBox - \row \o unsigned int - \row \o QDate \o QDateEdit - \row \o QDateTime \o QDateTimeEdit - \row \o QPixmap \o QLabel - \row \o QString \o QLineEdit - \row \o QTime \o QTimeEdit + \header \li Type \li Editor Widget + \row \li bool \li QComboBox + \row \li double \li QDoubleSpinBox + \row \li int \li{1,2} QSpinBox + \row \li unsigned int + \row \li QDate \li QDateEdit + \row \li QDateTime \li QDateTimeEdit + \row \li QPixmap \li QLabel + \row \li QString \li QLineEdit + \row \li QTime \li QTimeEdit \endtable Additional editors can be registered with the registerEditor() function. @@ -168,7 +168,7 @@ QItemEditorFactory::~QItemEditorFactory() /*! Registers an item editor creator specified by \a creator for the given \a userType of data. - \bold{Note:} The factory takes ownership of the item editor creator and will destroy + \b{Note:} The factory takes ownership of the item editor creator and will destroy it if a new creator for the same type is registered later. \sa createEditor() diff --git a/src/widgets/itemviews/qlistview.cpp b/src/widgets/itemviews/qlistview.cpp index 8d069a8c7e..b00b1073a3 100644 --- a/src/widgets/itemviews/qlistview.cpp +++ b/src/widgets/itemviews/qlistview.cpp @@ -108,12 +108,12 @@ QT_BEGIN_NAMESPACE be rendered as large or small icons depending on their iconSize(). \table 100% - \row \o \inlineimage windowsxp-listview.png Screenshot of a Windows XP style list view - \o \inlineimage macintosh-listview.png Screenshot of a Macintosh style table view - \o \inlineimage plastique-listview.png Screenshot of a Plastique style table view - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} list view. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} list view. - \o A \l{Plastique Style Widget Gallery}{Plastique style} list view. + \row \li \inlineimage windowsxp-listview.png Screenshot of a Windows XP style list view + \li \inlineimage macintosh-listview.png Screenshot of a Macintosh style table view + \li \inlineimage plastique-listview.png Screenshot of a Plastique style table view + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} list view. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} list view. + \li A \l{Plastique Style Widget Gallery}{Plastique style} list view. \endtable \section1 Improving Performance diff --git a/src/widgets/itemviews/qlistwidget.cpp b/src/widgets/itemviews/qlistwidget.cpp index bb39546ec8..01cb7b4235 100644 --- a/src/widgets/itemviews/qlistwidget.cpp +++ b/src/widgets/itemviews/qlistwidget.cpp @@ -1187,12 +1187,12 @@ void QListWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft, new current item and the item that was previously current. \table 100% - \row \o \inlineimage windowsxp-listview.png Screenshot of a Windows XP style list widget - \o \inlineimage macintosh-listview.png Screenshot of a Macintosh style table widget - \o \inlineimage plastique-listview.png Screenshot of a Plastique style table widget - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} list widget. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} list widget. - \o A \l{Plastique Style Widget Gallery}{Plastique style} list widget. + \row \li \inlineimage windowsxp-listview.png Screenshot of a Windows XP style list widget + \li \inlineimage macintosh-listview.png Screenshot of a Macintosh style table widget + \li \inlineimage plastique-listview.png Screenshot of a Plastique style table widget + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} list widget. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} list widget. + \li A \l{Plastique Style Widget Gallery}{Plastique style} list widget. \endtable \sa QListWidgetItem, QListView, QTreeView, {Model/View Programming}, diff --git a/src/widgets/itemviews/qstyleditemdelegate.cpp b/src/widgets/itemviews/qstyleditemdelegate.cpp index d54d78512a..93893afaa8 100644 --- a/src/widgets/itemviews/qstyleditemdelegate.cpp +++ b/src/widgets/itemviews/qstyleditemdelegate.cpp @@ -143,28 +143,28 @@ public: each of the roles to determine the appearance of items in views. \table - \header \o Role \o Accepted Types + \header \li Role \li Accepted Types \omit - \row \o \l Qt::AccessibleDescriptionRole \o QString - \row \o \l Qt::AccessibleTextRole \o QString + \row \li \l Qt::AccessibleDescriptionRole \li QString + \row \li \l Qt::AccessibleTextRole \li QString \endomit - \row \o \l Qt::BackgroundRole \o QBrush - \row \o \l Qt::BackgroundColorRole \o QColor (obsolete; use Qt::BackgroundRole instead) - \row \o \l Qt::CheckStateRole \o Qt::CheckState - \row \o \l Qt::DecorationRole \o QIcon, QPixmap, QImage and QColor - \row \o \l Qt::DisplayRole \o QString and types with a string representation - \row \o \l Qt::EditRole \o See QItemEditorFactory for details - \row \o \l Qt::FontRole \o QFont - \row \o \l Qt::SizeHintRole \o QSize + \row \li \l Qt::BackgroundRole \li QBrush + \row \li \l Qt::BackgroundColorRole \li QColor (obsolete; use Qt::BackgroundRole instead) + \row \li \l Qt::CheckStateRole \li Qt::CheckState + \row \li \l Qt::DecorationRole \li QIcon, QPixmap, QImage and QColor + \row \li \l Qt::DisplayRole \li QString and types with a string representation + \row \li \l Qt::EditRole \li See QItemEditorFactory for details + \row \li \l Qt::FontRole \li QFont + \row \li \l Qt::SizeHintRole \li QSize \omit - \row \o \l Qt::StatusTipRole \o + \row \li \l Qt::StatusTipRole \li \endomit - \row \o \l Qt::TextAlignmentRole \o Qt::Alignment - \row \o \l Qt::ForegroundRole \o QBrush - \row \o \l Qt::TextColorRole \o QColor (obsolete; use Qt::ForegroundRole instead) + \row \li \l Qt::TextAlignmentRole \li Qt::Alignment + \row \li \l Qt::ForegroundRole \li QBrush + \row \li \l Qt::TextColorRole \li QColor (obsolete; use Qt::ForegroundRole instead) \omit - \row \o \l Qt::ToolTipRole - \row \o \l Qt::WhatsThisRole + \row \li \l Qt::ToolTipRole + \row \li \l Qt::WhatsThisRole \endomit \endtable @@ -211,12 +211,12 @@ public: following virtual functions must be reimplemented: \list - \o createEditor() returns the widget used to change data from the model + \li createEditor() returns the widget used to change data from the model and can be reimplemented to customize editing behavior. - \o setEditorData() provides the widget with data to manipulate. - \o updateEditorGeometry() ensures that the editor is displayed correctly + \li setEditorData() provides the widget with data to manipulate. + \li updateEditorGeometry() ensures that the editor is displayed correctly with respect to the item view. - \o setModelData() returns updated data to the model. + \li setModelData() returns updated data to the model. \endlist The \l{Star Delegate Example}{Star Delegate} example creates @@ -618,11 +618,11 @@ void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory) key press events are handled by default: \list - \o \gui Tab - \o \gui Backtab - \o \gui Enter - \o \gui Return - \o \gui Esc + \li \gui Tab + \li \gui Backtab + \li \gui Enter + \li \gui Return + \li \gui Esc \endlist In the case of \gui Tab, \gui Backtab, \gui Enter and \gui Return diff --git a/src/widgets/itemviews/qtableview.cpp b/src/widgets/itemviews/qtableview.cpp index 7e6420bb53..d3bc826750 100644 --- a/src/widgets/itemviews/qtableview.cpp +++ b/src/widgets/itemviews/qtableview.cpp @@ -980,8 +980,8 @@ void QTableViewPrivate::drawCell(QPainter *painter, const QStyleOptionViewItemV4 later retrieved with \l{QAbstractItemView::}{indexWidget()}. \table - \row \o \inlineimage qtableview-resized.png - \o By default, the cells in a table do not expand to fill the available space. + \row \li \inlineimage qtableview-resized.png + \li By default, the cells in a table do not expand to fill the available space. You can make the cells fill the available space by stretching the last header section. Access the relevant header using horizontalHeader() @@ -1010,12 +1010,12 @@ void QTableViewPrivate::drawCell(QPainter *painter, const QStyleOptionViewItemV4 its appearance in other styles. \table 100% - \row \o \inlineimage windowsxp-tableview.png Screenshot of a Windows XP style table view - \o \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table view - \o \inlineimage plastique-tableview.png Screenshot of a Plastique style table view - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} table view. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} table view. - \o A \l{Plastique Style Widget Gallery}{Plastique style} table view. + \row \li \inlineimage windowsxp-tableview.png Screenshot of a Windows XP style table view + \li \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table view + \li \inlineimage plastique-tableview.png Screenshot of a Plastique style table view + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} table view. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} table view. + \li A \l{Plastique Style Widget Gallery}{Plastique style} table view. \endtable \sa QTableWidget, {View Classes}, QAbstractItemModel, QAbstractItemView, diff --git a/src/widgets/itemviews/qtablewidget.cpp b/src/widgets/itemviews/qtablewidget.cpp index 5932f20327..7ae74640d6 100644 --- a/src/widgets/itemviews/qtablewidget.cpp +++ b/src/widgets/itemviews/qtablewidget.cpp @@ -1537,12 +1537,12 @@ QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other) clear() function. \table 100% - \row \o \inlineimage windowsxp-tableview.png Screenshot of a Windows XP style table widget - \o \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table widget - \o \inlineimage plastique-tableview.png Screenshot of a Plastique style table widget - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} table widget. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} table widget. - \o A \l{Plastique Style Widget Gallery}{Plastique style} table widget. + \row \li \inlineimage windowsxp-tableview.png Screenshot of a Windows XP style table widget + \li \inlineimage macintosh-tableview.png Screenshot of a Macintosh style table widget + \li \inlineimage plastique-tableview.png Screenshot of a Plastique style table widget + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} table widget. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} table widget. + \li A \l{Plastique Style Widget Gallery}{Plastique style} table widget. \endtable \sa QTableWidgetItem, QTableView, {Model/View Programming} diff --git a/src/widgets/itemviews/qtreeview.cpp b/src/widgets/itemviews/qtreeview.cpp index 7f5e5964ab..c54c11d0f5 100644 --- a/src/widgets/itemviews/qtreeview.cpp +++ b/src/widgets/itemviews/qtreeview.cpp @@ -113,29 +113,29 @@ QT_BEGIN_NAMESPACE navigate in the view and interact with the contents of items: \table - \header \o Key \o Action - \row \o Up \o Moves the cursor to the item in the same column on + \header \li Key \li Action + \row \li Up \li Moves the cursor to the item in the same column on the previous row. If the parent of the current item has no more rows to navigate to, the cursor moves to the relevant item in the last row of the sibling that precedes the parent. - \row \o Down \o Moves the cursor to the item in the same column on + \row \li Down \li Moves the cursor to the item in the same column on the next row. If the parent of the current item has no more rows to navigate to, the cursor moves to the relevant item in the first row of the sibling that follows the parent. - \row \o Left \o Hides the children of the current item (if present) + \row \li Left \li Hides the children of the current item (if present) by collapsing a branch. - \row \o Minus \o Same as LeftArrow. - \row \o Right \o Reveals the children of the current item (if present) + \row \li Minus \li Same as LeftArrow. + \row \li Right \li Reveals the children of the current item (if present) by expanding a branch. - \row \o Plus \o Same as RightArrow. - \row \o Asterisk \o Expands all children of the current item (if present). - \row \o PageUp \o Moves the cursor up one page. - \row \o PageDown \o Moves the cursor down one page. - \row \o Home \o Moves the cursor to an item in the same column of the first + \row \li Plus \li Same as RightArrow. + \row \li Asterisk \li Expands all children of the current item (if present). + \row \li PageUp \li Moves the cursor up one page. + \row \li PageDown \li Moves the cursor down one page. + \row \li Home \li Moves the cursor to an item in the same column of the first row of the first top-level item in the model. - \row \o End \o Moves the cursor to an item in the same column of the last + \row \li End \li Moves the cursor to an item in the same column of the last row of the last top-level item in the model. - \row \o F2 \o In editable models, this opens the current item for editing. + \row \li F2 \li In editable models, this opens the current item for editing. The Escape key can be used to cancel the editing process and revert any changes to the data displayed. \endtable @@ -145,12 +145,12 @@ QT_BEGIN_NAMESPACE \endomit \table 100% - \row \o \inlineimage windowsxp-treeview.png Screenshot of a Windows XP style tree view - \o \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree view - \o \inlineimage plastique-treeview.png Screenshot of a Plastique style tree view - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} tree view. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} tree view. - \o A \l{Plastique Style Widget Gallery}{Plastique style} tree view. + \row \li \inlineimage windowsxp-treeview.png Screenshot of a Windows XP style tree view + \li \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree view + \li \inlineimage plastique-treeview.png Screenshot of a Plastique style tree view + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} tree view. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} tree view. + \li A \l{Plastique Style Widget Gallery}{Plastique style} tree view. \endtable \section1 Improving Performance @@ -3146,7 +3146,7 @@ void QTreeViewPrivate::_q_columnsRemoved(const QModelIndex &parent, int start, i } /** \internal - creates and initialize the viewItem structure of the children of the element \i + creates and initialize the viewItem structure of the children of the element \li set \a recursiveExpanding if the function has to expand all the children (called from expandAll) \a afterIsUninitialized is when we recurse from layout(-1), it means all the items after 'i' are diff --git a/src/widgets/itemviews/qtreewidget.cpp b/src/widgets/itemviews/qtreewidget.cpp index cec709a816..156121a533 100644 --- a/src/widgets/itemviews/qtreewidget.cpp +++ b/src/widgets/itemviews/qtreewidget.cpp @@ -2376,12 +2376,12 @@ void QTreeWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft, whether sorting is enabled. \table 100% - \row \o \inlineimage windowsxp-treeview.png Screenshot of a Windows XP style tree widget - \o \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree widget - \o \inlineimage plastique-treeview.png Screenshot of a Plastique style tree widget - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} tree widget. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} tree widget. - \o A \l{Plastique Style Widget Gallery}{Plastique style} tree widget. + \row \li \inlineimage windowsxp-treeview.png Screenshot of a Windows XP style tree widget + \li \inlineimage macintosh-treeview.png Screenshot of a Macintosh style tree widget + \li \inlineimage plastique-treeview.png Screenshot of a Plastique style tree widget + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} tree widget. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} tree widget. + \li A \l{Plastique Style Widget Gallery}{Plastique style} tree widget. \endtable \sa QTreeWidgetItem, QTreeWidgetItemIterator, QTreeView, @@ -3263,7 +3263,7 @@ void QTreeWidget::collapseItem(const QTreeWidgetItem *item) /*! Clears the tree widget by removing all of its items and selections. - \bold{Note:} Since each item is removed from the tree widget before being + \b{Note:} Since each item is removed from the tree widget before being deleted, the return value of QTreeWidgetItem::treeWidget() will be invalid when called from an item's destructor. diff --git a/src/widgets/kernel/qapplication.cpp b/src/widgets/kernel/qapplication.cpp index c350223278..095b58eeaf 100644 --- a/src/widgets/kernel/qapplication.cpp +++ b/src/widgets/kernel/qapplication.cpp @@ -185,7 +185,7 @@ QApplicationPrivate::~QApplicationPrivate() for QWidget-based applications. It handles widget specific initialization, finalization, and provides session management. - For any GUI application using Qt, there is precisely \bold one QApplication + For any GUI application using Qt, there is precisely \b one QApplication object, no matter whether the application has 0, 1, 2 or more windows at any given time. For non-QWidget based Qt applications, use QGuiApplication instead, as it does not depend on the \l QtWidgets library. @@ -195,41 +195,41 @@ QApplicationPrivate::~QApplicationPrivate() QApplication's main areas of responsibility are: \list - \o It initializes the application with the user's desktop settings + \li It initializes the application with the user's desktop settings such as palette(), font() and doubleClickInterval(). It keeps track of these properties in case the user changes the desktop globally, for example through some kind of control panel. - \o It performs event handling, meaning that it receives events + \li It performs event handling, meaning that it receives events from the underlying window system and dispatches them to the relevant widgets. By using sendEvent() and postEvent() you can send your own events to widgets. - \o It parses common command line arguments and sets its internal + \li It parses common command line arguments and sets its internal state accordingly. See the \l{QApplication::QApplication()} {constructor documentation} below for more details. - \o It defines the application's look and feel, which is + \li It defines the application's look and feel, which is encapsulated in a QStyle object. This can be changed at runtime with setStyle(). - \o It specifies how the application is to allocate colors. See + \li It specifies how the application is to allocate colors. See setColorSpec() for details. - \o It provides localization of strings that are visible to the + \li It provides localization of strings that are visible to the user via translate(). - \o It provides some magical objects like the desktop() and the + \li It provides some magical objects like the desktop() and the clipboard(). - \o It knows about the application's windows. You can ask which + \li It knows about the application's windows. You can ask which widget is at a certain position using widgetAt(), get a list of topLevelWidgets() and closeAllWindows(), etc. - \o It manages the application's mouse cursor handling, see + \li It manages the application's mouse cursor handling, see setOverrideCursor() - \o It provides support for sophisticated \l{Session Management} + \li It provides support for sophisticated \l{Session Management} {session management}. This makes it possible for applications to terminate gracefully when the user logs out, to cancel a shutdown process if termination isn't possible and even to @@ -246,11 +246,11 @@ QApplicationPrivate::~QApplicationPrivate() \table \header - \o{2,1} Groups of functions + \li{2,1} Groups of functions \row - \o System settings - \o desktopSettingsAware(), + \li System settings + \li desktopSettingsAware(), setDesktopSettingsAware(), cursorFlashTime(), setCursorFlashTime(), @@ -266,8 +266,8 @@ QApplicationPrivate::~QApplicationPrivate() fontMetrics(). \row - \o Event handling - \o exec(), + \li Event handling + \li exec(), processEvents(), exit(), quit(). @@ -279,24 +279,24 @@ QApplicationPrivate::~QApplicationPrivate() notify(). \row - \o GUI Styles - \o style(), + \li GUI Styles + \li style(), setStyle(). \row - \o Color usage - \o colorSpec(), + \li Color usage + \li colorSpec(), setColorSpec(). \row - \o Text handling - \o installTranslator(), + \li Text handling + \li installTranslator(), removeTranslator() translate(). \row - \o Widgets - \o allWidgets(), + \li Widgets + \li allWidgets(), topLevelWidgets(), desktop(), activePopupWidget(), @@ -307,21 +307,21 @@ QApplicationPrivate::~QApplicationPrivate() widgetAt(). \row - \o Advanced cursor handling - \o overrideCursor(), + \li Advanced cursor handling + \li overrideCursor(), setOverrideCursor(), restoreOverrideCursor(). \row - \o Session management - \o isSessionRestored(), + \li Session management + \li isSessionRestored(), sessionId(), commitData(), saveState(). \row - \o Miscellaneous - \o closeAllWindows(), + \li Miscellaneous + \li closeAllWindows(), startingUp(), closingDown(), type(). @@ -534,25 +534,25 @@ void QApplicationPrivate::process_cmdline() All Qt programs automatically support the following command line options: \list - \o -style= \e style, sets the application GUI style. Possible values + \li -style= \e style, sets the application GUI style. Possible values are \c motif, \c windows, and \c platinum. If you compiled Qt with additional styles or have additional styles as plugins these will be available to the \c -style command line option. - \o -style \e style, is the same as listed above. - \o -stylesheet= \e stylesheet, sets the application \l styleSheet. The + \li -style \e style, is the same as listed above. + \li -stylesheet= \e stylesheet, sets the application \l styleSheet. The value must be a path to a file that contains the Style Sheet. \note Relative URLs in the Style Sheet file are relative to the Style Sheet file's path. - \o -stylesheet \e stylesheet, is the same as listed above. - \o -session= \e session, restores the application from an earlier + \li -stylesheet \e stylesheet, is the same as listed above. + \li -session= \e session, restores the application from an earlier \l{Session Management}{session}. - \o -session \e session, is the same as listed above. - \o -widgetcount, prints debug message at the end about number of + \li -session \e session, is the same as listed above. + \li -widgetcount, prints debug message at the end about number of widgets left undestroyed and maximum number of widgets existed at the same time - \o -reverse, sets the application's layout direction to + \li -reverse, sets the application's layout direction to Qt::RightToLeft - \o -qmljsdebugger=, activates the QML/JS debugger with a specified port. + \li -qmljsdebugger=, activates the QML/JS debugger with a specified port. The value must be of format port:1234[,block], where block is optional and will make the application wait until a debugger connects to it. \endlist @@ -968,7 +968,7 @@ bool QApplication::compressEvent(QEvent *event, QObject *receiver, QPostEventLis \since 4.4 \brief defines a threshold for auto maximizing widgets - \bold{The auto maximize threshold is only available as part of Qt for + \b{The auto maximize threshold is only available as part of Qt for Windows CE.} This property defines a threshold for the size of a window as a percentage @@ -997,7 +997,7 @@ bool QApplication::compressEvent(QEvent *event, QObject *receiver, QPostEventLis the WA_InputMethodEnabled attribute set, and is typically used to launch a virtual keyboard on devices which have very few or no keys. - \bold{ The property only has an effect on platforms which use software input + \b{ The property only has an effect on platforms which use software input panels, such as Windows CE.} The default is platform dependent. @@ -1275,21 +1275,21 @@ int QApplication::colorSpec() The options are: \list - \o QApplication::NormalColor. This is the default color allocation + \li QApplication::NormalColor. This is the default color allocation strategy. Use this option if your application uses buttons, menus, texts and pixmaps with few colors. With this option, the application uses system global colors. This works fine for most applications under X11, but on the Windows platform, it may cause dithering of non-standard colors. - \o QApplication::CustomColor. Use this option if your application + \li QApplication::CustomColor. Use this option if your application needs a small number of custom colors. On X11, this option is the same as NormalColor. On Windows, Qt creates a Windows palette, and allocates colors to it on demand. - \o QApplication::ManyColor. Use this option if your application is + \li QApplication::ManyColor. Use this option if your application is very color hungry, e.g., it requires thousands of colors. \br Under X11 the effect is: \list - \o For 256-color displays which have at best a 256 color true + \li For 256-color displays which have at best a 256 color true color visual, the default visual is used, and colors are allocated from a color cube. The color cube is the 6x6x6 (216 color) "Web palette" (the red, green, and blue @@ -1298,7 +1298,7 @@ int QApplication::colorSpec() can be changed by the \e -ncols option. The user can force the application to use the true color visual with the \l{QApplication::QApplication()}{-visual} option. - \o For 256-color displays which have a true color visual with + \li For 256-color displays which have a true color visual with more than 256 colors, use that visual. Silicon Graphics X servers this feature, for example. They provide an 8 bit visual by default but can deliver true color when asked. diff --git a/src/widgets/kernel/qboxlayout.cpp b/src/widgets/kernel/qboxlayout.cpp index 4b7153715d..7ea77d211c 100644 --- a/src/widgets/kernel/qboxlayout.cpp +++ b/src/widgets/kernel/qboxlayout.cpp @@ -487,17 +487,17 @@ void QBoxLayoutPrivate::calcHfw(int w) one of four functions: \list - \o addWidget() to add a widget to the QBoxLayout and set the + \li addWidget() to add a widget to the QBoxLayout and set the widget's stretch factor. (The stretch factor is along the row of boxes.) - \o addSpacing() to create an empty box; this is one of the + \li addSpacing() to create an empty box; this is one of the functions you use to create nice and spacious dialogs. See below for ways to set margins. - \o addStretch() to create an empty, stretchable box. + \li addStretch() to create an empty, stretchable box. - \o addLayout() to add a box containing another QLayout to the row + \li addLayout() to add a box containing another QLayout to the row and set that layout's stretch factor. \endlist @@ -508,10 +508,10 @@ void QBoxLayoutPrivate::calcHfw(int w) QBoxLayout also includes two margin widths: \list - \o setContentsMargins() sets the width of the outer border on + \li setContentsMargins() sets the width of the outer border on each side of the widget. This is the width of the reserved space along each of the QBoxLayout's four sides. - \o setSpacing() sets the width between neighboring boxes. (You + \li setSpacing() sets the width between neighboring boxes. (You can use addSpacing() to get more space at a particular spot.) \endlist diff --git a/src/widgets/kernel/qformlayout.cpp b/src/widgets/kernel/qformlayout.cpp index dd61528124..440f3f1dc2 100644 --- a/src/widgets/kernel/qformlayout.cpp +++ b/src/widgets/kernel/qformlayout.cpp @@ -1019,20 +1019,20 @@ QStyle* QFormLayoutPrivate::getStyle() const provides the following advantages: \list - \o \bold{Adherence to the different platform's look and feel guidelines.} + \li \b{Adherence to the different platform's look and feel guidelines.} For example, the \l{Mac OS X Aqua} and KDE guidelines specify that the labels should be right-aligned, whereas Windows and GNOME applications normally use left-alignment. - \o \bold{Support for wrapping long rows.} + \li \b{Support for wrapping long rows.} For devices with small displays, QFormLayout can be set to \l{WrapLongRows}{wrap long rows}, or even to \l{WrapAllRows}{wrap all rows}. - \o \bold{Convenient API for creating label--field pairs.} + \li \b{Convenient API for creating label--field pairs.} The addRow() overload that takes a QString and a QWidget * creates a QLabel behind the scenes and automatically set up @@ -1049,30 +1049,30 @@ QStyle* QFormLayoutPrivate::getStyle() const \table \header - \o QCommonStyle derived styles (except QPlastiqueStyle) - \o QMacStyle - \o QPlastiqueStyle - \o Qt Extended styles + \li QCommonStyle derived styles (except QPlastiqueStyle) + \li QMacStyle + \li QPlastiqueStyle + \li Qt Extended styles \row - \o \inlineimage qformlayout-win.png - \o \inlineimage qformlayout-mac.png - \o \inlineimage qformlayout-kde.png - \o \inlineimage qformlayout-qpe.png + \li \inlineimage qformlayout-win.png + \li \inlineimage qformlayout-mac.png + \li \inlineimage qformlayout-kde.png + \li \inlineimage qformlayout-qpe.png \row - \o Traditional style used for Windows, GNOME, and earlier + \li Traditional style used for Windows, GNOME, and earlier versions of KDE. Labels are left aligned, and expanding fields grow to fill the available space. (This normally corresponds to what we would get using a two-column QGridLayout.) - \o Style based on the + \li Style based on the \l{Mac OS X Aqua} guidelines. Labels are right-aligned, the fields don't grow beyond their size hint, and the form is horizontally centered. - \o Recommended style for + \li Recommended style for \l{KDE applications}. Similar to MacStyle, except that the form is left-aligned and all fields grow to fill the available space. - \o Default style for Qt Extended styles. Labels are right-aligned, + \li Default style for Qt Extended styles. Labels are right-aligned, expanding fields grow to fill the available space, and row wrapping is enabled for long lines. \endtable @@ -1966,7 +1966,7 @@ void QFormLayoutPrivate::arrangeWidgets(const QVector<QLayoutStruct>& layouts, Q If the cell is already occupied, the \a widget is not inserted and an error message is sent to the console. - \bold{Note:} For most applications, addRow() or insertRow() should be used instead of setWidget(). + \b{Note:} For most applications, addRow() or insertRow() should be used instead of setWidget(). \sa setLayout() */ @@ -1986,7 +1986,7 @@ void QFormLayout::setWidget(int row, ItemRole role, QWidget *widget) If the cell is already occupied, the \a layout is not inserted and an error message is sent to the console. - \bold{Note:} For most applications, addRow() or insertRow() should be used instead of setLayout(). + \b{Note:} For most applications, addRow() or insertRow() should be used instead of setLayout(). \sa setWidget() */ diff --git a/src/widgets/kernel/qicon.cpp b/src/widgets/kernel/qicon.cpp index eebd57f97e..4f244b1027 100644 --- a/src/widgets/kernel/qicon.cpp +++ b/src/widgets/kernel/qicon.cpp @@ -945,8 +945,8 @@ QString QIcon::themeName() specification can be obtained here: \list - \o \l{http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html} - \o \l{http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html} + \li \l{http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html} + \li \l{http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html} \endlist To fetch an icon from the current icon theme: diff --git a/src/widgets/kernel/qiconengineplugin.cpp b/src/widgets/kernel/qiconengineplugin.cpp index ced4f5dd3e..26c9e7890a 100644 --- a/src/widgets/kernel/qiconengineplugin.cpp +++ b/src/widgets/kernel/qiconengineplugin.cpp @@ -51,7 +51,7 @@ QT_BEGIN_NAMESPACE \ingroup plugins \inmodule QtWidgets - \bold {Use QIconEnginePluginV2 instead.} + \b {Use QIconEnginePluginV2 instead.} The icon engine plugin is a simple plugin interface that makes it easy to create custom icon engines that can be loaded dynamically into applications diff --git a/src/widgets/kernel/qlayout.cpp b/src/widgets/kernel/qlayout.cpp index d5d739e431..541350c35c 100644 --- a/src/widgets/kernel/qlayout.cpp +++ b/src/widgets/kernel/qlayout.cpp @@ -215,7 +215,7 @@ QSpacerItem *QLayoutPrivate::createSpacerItem(const QLayout *layout, int w, int to a layout, use the addWidget() function; to add a child layout, use the addLayout() function provided by the relevant QLayout subclass. - \bold{Note:} The ownership of \a item is transferred to the layout, and it's + \b{Note:} The ownership of \a item is transferred to the layout, and it's the layout's responsibility to delete it. \sa addWidget(), QBoxLayout::addLayout(), QGridLayout::addLayout() @@ -1270,7 +1270,7 @@ QRect QLayout::alignmentRect(const QRect &r) const is the caller's responsibility to give the widget a reasonable geometry or to put the widget back into a layout. - \bold{Note:} The ownership of \a widget remains the same as + \b{Note:} The ownership of \a widget remains the same as when it was added. \sa removeItem(), QWidget::setGeometry(), addWidget() diff --git a/src/widgets/kernel/qlayoutitem.cpp b/src/widgets/kernel/qlayoutitem.cpp index 664334d725..814b807b82 100644 --- a/src/widgets/kernel/qlayoutitem.cpp +++ b/src/widgets/kernel/qlayoutitem.cpp @@ -127,15 +127,15 @@ QSizePolicy::operator QVariant() const manipulating empty space in layouts: \table - \header \o Class - \o Functions - \row \o QHBoxLayout - \o \l{QBoxLayout::addSpacing()}{addSpacing()}, + \header \li Class + \li Functions + \row \li QHBoxLayout + \li \l{QBoxLayout::addSpacing()}{addSpacing()}, \l{QBoxLayout::addStretch()}{addStretch()}, \l{QBoxLayout::insertSpacing()}{insertSpacing()}, \l{QBoxLayout::insertStretch()}{insertStretch()} - \row \o QGridLayout - \o \l{QGridLayout::setRowMinimumHeight()}{setRowMinimumHeight()}, + \row \li QGridLayout + \li \l{QGridLayout::setRowMinimumHeight()}{setRowMinimumHeight()}, \l{QGridLayout::setRowStretch()}{setRowStretch()}, \l{QGridLayout::setColumnMinimumWidth()}{setColumnMinimumWidth()}, \l{QGridLayout::setColumnStretch()}{setColumnStretch()} @@ -156,16 +156,16 @@ QSizePolicy::operator QVariant() const manipulating widgets in layouts: \table - \header \o Class - \o Functions - \row \o QBoxLayout - \o \l{QBoxLayout::addWidget()}{addWidget()}, + \header \li Class + \li Functions + \row \li QBoxLayout + \li \l{QBoxLayout::addWidget()}{addWidget()}, \l{QBoxLayout::insertWidget()}{insertWidget()}, \l{QBoxLayout::setStretchFactor()}{setStretchFactor()} - \row \o QGridLayout - \o \l{QGridLayout::addWidget()}{addWidget()} - \row \o QStackedLayout - \o \l{QStackedLayout::addWidget()}{addWidget()}, + \row \li QGridLayout + \li \l{QGridLayout::addWidget()}{addWidget()} + \row \li QStackedLayout + \li \l{QStackedLayout::addWidget()}{addWidget()}, \l{QStackedLayout::insertWidget()}{insertWidget()}, \l{QStackedLayout::currentWidget()}{currentWidget()}, \l{QStackedLayout::setCurrentWidget()}{setCurrentWidget()}, @@ -191,7 +191,7 @@ QSizePolicy::operator QVariant() const /*! Sets the alignment of this item to \a alignment. - \bold{Note:} Item alignment is only supported by QLayoutItem subclasses + \b{Note:} Item alignment is only supported by QLayoutItem subclasses where it would have a visual effect. Except for QSpacerItem, which provides blank space for layouts, all public Qt classes that inherit QLayoutItem support item alignment. diff --git a/src/widgets/kernel/qwidget.cpp b/src/widgets/kernel/qwidget.cpp index 44995f0959..5eee5752cc 100644 --- a/src/widgets/kernel/qwidget.cpp +++ b/src/widgets/kernel/qwidget.cpp @@ -484,11 +484,11 @@ void QWidget::setAutoFillBackground(bool enabled) Every widget's constructor accepts one or two standard arguments: \list 1 - \i \c{QWidget *parent = 0} is the parent of the new widget. If it is 0 + \li \c{QWidget *parent = 0} is the parent of the new widget. If it is 0 (the default), the new widget will be a window. If not, it will be a child of \e parent, and be constrained by \e parent's geometry (unless you specify Qt::Window as window flag). - \i \c{Qt::WindowFlags f = 0} (where available) sets the window flags; + \li \c{Qt::WindowFlags f = 0} (where available) sets the window flags; the default is suitable for almost all widgets, but to get, for example, a window without a window system frame, you must use special flags. @@ -593,16 +593,16 @@ void QWidget::setAutoFillBackground(bool enabled) starting with the most common ones: \list - \i paintEvent() is called whenever the widget needs to be repainted. + \li paintEvent() is called whenever the widget needs to be repainted. Every widget displaying custom content must implement it. Painting using a QPainter can only take place in a paintEvent() or a function called by a paintEvent(). - \i resizeEvent() is called when the widget has been resized. - \i mousePressEvent() is called when a mouse button is pressed while + \li resizeEvent() is called when the widget has been resized. + \li mousePressEvent() is called when a mouse button is pressed while the mouse cursor is inside the widget, or when the widget has grabbed the mouse using grabMouse(). Pressing the mouse without releasing it is effectively the same as calling grabMouse(). - \i mouseReleaseEvent() is called when a mouse button is released. A + \li mouseReleaseEvent() is called when a mouse button is released. A widget receives mouse release events when it has received the corresponding mouse press event. This means that if the user presses the mouse inside \e your widget, then drags the mouse @@ -610,7 +610,7 @@ void QWidget::setAutoFillBackground(bool enabled) receives the release event. There is one exception: if a popup menu appears while the mouse button is held down, this popup immediately steals the mouse events. - \i mouseDoubleClickEvent() is called when the user double-clicks in + \li mouseDoubleClickEvent() is called when the user double-clicks in the widget. If the user double-clicks, the widget receives a mouse press event, a mouse release event and finally this event instead of a second mouse press event. (Some mouse move events may also be @@ -625,46 +625,46 @@ void QWidget::setAutoFillBackground(bool enabled) handlers: \list - \i keyPressEvent() is called whenever a key is pressed, and again when + \li keyPressEvent() is called whenever a key is pressed, and again when a key has been held down long enough for it to auto-repeat. The \key Tab and \key Shift+Tab keys are only passed to the widget if they are not used by the focus-change mechanisms. To force those keys to be processed by your widget, you must reimplement QWidget::event(). - \i focusInEvent() is called when the widget gains keyboard focus + \li focusInEvent() is called when the widget gains keyboard focus (assuming you have called setFocusPolicy()). Well-behaved widgets indicate that they own the keyboard focus in a clear but discreet way. - \i focusOutEvent() is called when the widget loses keyboard focus. + \li focusOutEvent() is called when the widget loses keyboard focus. \endlist You may be required to also reimplement some of the less common event handlers: \list - \i mouseMoveEvent() is called whenever the mouse moves while a mouse + \li mouseMoveEvent() is called whenever the mouse moves while a mouse button is held down. This can be useful during drag and drop operations. If you call \l{setMouseTracking()}{setMouseTracking}(true), you get mouse move events even when no buttons are held down. (See also the \l{Drag and Drop} guide.) - \i keyReleaseEvent() is called whenever a key is released and while it + \li keyReleaseEvent() is called whenever a key is released and while it is held down (if the key is auto-repeating). In that case, the widget will receive a pair of key release and key press event for every repeat. The \key Tab and \key Shift+Tab keys are only passed to the widget if they are not used by the focus-change mechanisms. To force those keys to be processed by your widget, you must reimplement QWidget::event(). - \i wheelEvent() is called whenever the user turns the mouse wheel + \li wheelEvent() is called whenever the user turns the mouse wheel while the widget has the focus. - \i enterEvent() is called when the mouse enters the widget's screen + \li enterEvent() is called when the mouse enters the widget's screen space. (This excludes screen space owned by any of the widget's children.) - \i leaveEvent() is called when the mouse leaves the widget's screen + \li leaveEvent() is called when the mouse leaves the widget's screen space. If the mouse enters a child widget it will not cause a leaveEvent(). - \i moveEvent() is called when the widget has been moved relative to + \li moveEvent() is called when the widget has been moved relative to its parent. - \i closeEvent() is called when the user closes the widget (or when + \li closeEvent() is called when the user closes the widget (or when close() is called). \endlist @@ -682,27 +682,27 @@ void QWidget::setAutoFillBackground(bool enabled) \section1 Groups of Functions and Properties \table - \header \i Context \i Functions and Properties + \header \li Context \li Functions and Properties - \row \i Window functions \i + \row \li Window functions \li show(), hide(), raise(), lower(), close(). - \row \i Top-level windows \i + \row \li Top-level windows \li \l windowModified, \l windowTitle, \l windowIcon, \l windowIconText, \l isActiveWindow, activateWindow(), \l minimized, showMinimized(), \l maximized, showMaximized(), \l fullScreen, showFullScreen(), showNormal(). - \row \i Window contents \i + \row \li Window contents \li update(), repaint(), scroll(). - \row \i Geometry \i + \row \li Geometry \li \l pos, x(), y(), \l rect, \l size, width(), height(), move(), resize(), \l sizePolicy, sizeHint(), minimumSizeHint(), updateGeometry(), layout(), @@ -713,7 +713,7 @@ void QWidget::setAutoFillBackground(bool enabled) \l maximumSize, \l minimumSize, \l sizeIncrement, \l baseSize, setFixedSize() - \row \i Mode \i + \row \li Mode \li \l visible, isVisibleTo(), \l enabled, isEnabledTo(), \l modal, @@ -722,7 +722,7 @@ void QWidget::setAutoFillBackground(bool enabled) \l updatesEnabled, visibleRegion(). - \row \i Look and feel \i + \row \li Look and feel \li style(), setStyle(), \l styleSheet, @@ -732,17 +732,17 @@ void QWidget::setAutoFillBackground(bool enabled) backgroundRole(), setBackgroundRole(), fontInfo(), fontMetrics(). - \row \i Keyboard focus functions \i + \row \li Keyboard focus functions \li \l focus, \l focusPolicy, setFocus(), clearFocus(), setTabOrder(), setFocusProxy(), focusNextChild(), focusPreviousChild(). - \row \i Mouse and keyboard grabbing \i + \row \li Mouse and keyboard grabbing \li grabMouse(), releaseMouse(), grabKeyboard(), releaseKeyboard(), mouseGrabber(), keyboardGrabber(). - \row \i Event handlers \i + \row \li Event handlers \li event(), mousePressEvent(), mouseReleaseEvent(), @@ -769,11 +769,11 @@ void QWidget::setAutoFillBackground(bool enabled) customEvent(). changeEvent(), - \row \i System functions \i + \row \li System functions \li parentWidget(), window(), setParent(), winId(), find(), metric(). - \row \i Interactive help \i + \row \li Interactive help \li setToolTip(), setWhatsThis() \endtable @@ -815,15 +815,15 @@ void QWidget::setAutoFillBackground(bool enabled) achieve different effects: \list - \i The left widget has no additional properties or widget attributes + \li The left widget has no additional properties or widget attributes set. This default state suits most custom widgets using transparency, are irregularly-shaped, or do not paint over their entire area with an opaque brush. - \i The center widget has the \l autoFillBackground property set. This + \li The center widget has the \l autoFillBackground property set. This property is used with custom widgets that rely on the widget to supply a default background, and do not paint over their entire area with an opaque brush. - \i The right widget has the Qt::WA_OpaquePaintEvent widget attribute + \li The right widget has the Qt::WA_OpaquePaintEvent widget attribute set. This indicates that the widget will paint over its entire area with opaque colors. The widget's area will initially be \e{uninitialized}, represented in the diagram with a red diagonal @@ -874,9 +874,9 @@ void QWidget::setAutoFillBackground(bool enabled) Platform notes: \list - \o X11: This feature relies on the use of an X server that supports ARGB visuals + \li X11: This feature relies on the use of an X server that supports ARGB visuals and a compositing window manager. - \o Windows: The widget needs to have the Qt::FramelessWindowHint window flag set + \li Windows: The widget needs to have the Qt::FramelessWindowHint window flag set for the translucency to work. \endlist @@ -891,14 +891,14 @@ void QWidget::setAutoFillBackground(bool enabled) one of the following options: \list 1 - \i Use the \c{QT_USE_NATIVE_WINDOWS=1} in your environment. - \i Set the Qt::AA_NativeWindows attribute on your application. All + \li Use the \c{QT_USE_NATIVE_WINDOWS=1} in your environment. + \li Set the Qt::AA_NativeWindows attribute on your application. All widgets will be native widgets. - \i Set the Qt::WA_NativeWindow attribute on widgets: The widget itself + \li Set the Qt::WA_NativeWindow attribute on widgets: The widget itself and all of its ancestors will become native (unless Qt::WA_DontCreateNativeAncestors is set). - \i Call QWidget::winId to enforce a native window (this implies 3). - \i Set the Qt::WA_PaintOnScreen attribute to enforce a native window + \li Call QWidget::winId to enforce a native window (this implies 3). + \li Set the Qt::WA_PaintOnScreen attribute to enforce a native window (this implies 3). \endlist @@ -957,17 +957,17 @@ QRegion qt_dirtyRegion(QWidget *widget) /* Widget state flags: \list - \i Qt::WA_WState_Created The widget has a valid winId(). - \i Qt::WA_WState_Visible The widget is currently visible. - \i Qt::WA_WState_Hidden The widget is hidden, i.e. it won't + \li Qt::WA_WState_Created The widget has a valid winId(). + \li Qt::WA_WState_Visible The widget is currently visible. + \li Qt::WA_WState_Hidden The widget is hidden, i.e. it won't become visible unless you call show() on it. Qt::WA_WState_Hidden implies !Qt::WA_WState_Visible. - \i Qt::WA_WState_CompressKeys Compress keyboard events. - \i Qt::WA_WState_BlockUpdates Repaints and updates are disabled. - \i Qt::WA_WState_InPaintEvent Currently processing a paint event. - \i Qt::WA_WState_Reparented The widget has been reparented. - \i Qt::WA_WState_ConfigPending A configuration (resize/move) event is pending. - \i Qt::WA_WState_DND (Deprecated) The widget supports drag and drop, see setAcceptDrops(). + \li Qt::WA_WState_CompressKeys Compress keyboard events. + \li Qt::WA_WState_BlockUpdates Repaints and updates are disabled. + \li Qt::WA_WState_InPaintEvent Currently processing a paint event. + \li Qt::WA_WState_Reparented The widget has been reparented. + \li Qt::WA_WState_ConfigPending A configuration (resize/move) event is pending. + \li Qt::WA_WState_DND (Deprecated) The widget supports drag and drop, see setAcceptDrops(). \endlist */ @@ -5689,16 +5689,16 @@ QString QWidget::windowIconText() const On Mac OS X: \list - \o The file name of the specified path, obtained using QFileInfo::fileName(). + \li The file name of the specified path, obtained using QFileInfo::fileName(). \endlist On Windows and X11: \list - \o The file name of the specified path, obtained using QFileInfo::fileName(). - \o An optional \c{*} character, if the \l windowModified property is set. - \o The \c{0x2014} unicode character, padded either side by spaces. - \o The application name, obtained from the application's + \li The file name of the specified path, obtained using QFileInfo::fileName(). + \li An optional \c{*} character, if the \l windowModified property is set. + \li The \c{0x2014} unicode character, padded either side by spaces. + \li The application name, obtained from the application's \l{QCoreApplication::}{applicationName} property. \endlist @@ -7164,9 +7164,9 @@ void QWidgetPrivate::hide_helper() Widgets are hidden if: \list - \o they were created as independent windows, - \o they were created as children of visible widgets, - \o hide() or setVisible(false) was called. + \li they were created as independent windows, + \li they were created as children of visible widgets, + \li hide() or setVisible(false) was called. \endlist */ @@ -8587,9 +8587,9 @@ void QWidget::leaveEvent(QEvent *) happen for one of the following reasons: \list - \o repaint() or update() was invoked, - \o the widget was obscured and has now been uncovered, or - \o many other reasons. + \li repaint() or update() was invoked, + \li the widget was obscured and has now been uncovered, or + \li many other reasons. \endlist Many widgets can simply repaint their entire surface when asked to, but @@ -8612,13 +8612,13 @@ void QWidget::leaveEvent(QEvent *) Since Qt 4.0, QWidget automatically double-buffers its painting, so there is no need to write double-buffering code in paintEvent() to avoid flicker. - \bold{Note for the X11 platform}: It is possible to toggle global double + \b{Note for the X11 platform}: It is possible to toggle global double buffering by calling \c qt_x11_set_global_double_buffer(). For example, \snippet doc/src/snippets/code/src_gui_kernel_qwidget.cpp 14 \note Generally, you should refrain from calling update() or repaint() - \bold{inside} a paintEvent(). For example, calling update() or repaint() on + \b{inside} a paintEvent(). For example, calling update() or repaint() on children inside a paintevent() results in undefined behavior; the child may or may not get a paint event. @@ -8960,8 +8960,8 @@ void QWidget::hideEvent(QHideEvent *) x11Event(), winEvent() and macEvent() of Qt 4. \table - \header \i Platform \i Event Type Identifier \i Message Type \i Result Type - \row \i Windows \i "windows_generic_MSG" \i MSG * \i LRESULT + \header \li Platform \li Event Type Identifier \li Message Type \li Result Type + \row \li Windows \li "windows_generic_MSG" \li MSG * \li LRESULT \endtable */ @@ -8991,7 +8991,7 @@ bool QWidget::nativeEvent(const QByteArray &eventType, void *message, long *resu If you need to change some settings when a widget is polished, reimplement event() and handle the QEvent::Polish event type. - \bold{Note:} The function is declared const so that it can be called from + \b{Note:} The function is declared const so that it can be called from other const functions (e.g., sizeHint()). \sa event() @@ -11081,7 +11081,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) \note Only visible widgets can grab mouse input. If isVisible() returns false for a widget, that widget cannot call grabMouse(). - \note \bold{(Mac OS X developers)} For \e Cocoa, calling + \note \b{(Mac OS X developers)} For \e Cocoa, calling grabMouse() on a widget only works when the mouse is inside the frame of that widget. For \e Carbon, it works outside the widget's frame as well, like for Windows and X11. @@ -11101,7 +11101,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) \warning Grabbing the mouse might lock the terminal. - \note \bold{(Mac OS X developers)} See the note in QWidget::grabMouse(). + \note \b{(Mac OS X developers)} See the note in QWidget::grabMouse(). \sa releaseMouse(), grabKeyboard(), releaseKeyboard(), setCursor() */ diff --git a/src/widgets/kernel/qwidgetaction.cpp b/src/widgets/kernel/qwidgetaction.cpp index 14369513da..c3fc6c7cfb 100644 --- a/src/widgets/kernel/qwidgetaction.cpp +++ b/src/widgets/kernel/qwidgetaction.cpp @@ -87,17 +87,17 @@ QT_BEGIN_NAMESPACE Note that it is up to the widget to activate the action, for example by reimplementing mouse event handlers and calling QAction::trigger(). - \bold {Mac OS X}: If you add a widget to a menu in the application's menu + \b {Mac OS X}: If you add a widget to a menu in the application's menu bar on Mac OS X, the widget will be added and it will function but with some limitations: \list 1 - \o The widget is reparented away from the QMenu to the native menu + \li The widget is reparented away from the QMenu to the native menu view. If you show the menu in some other place (e.g. as a popup menu), the widget will not be there. - \o Focus/Keyboard handling of the widget is not possible. - \o Due to Apple's design, mouse tracking on the widget currently does + \li Focus/Keyboard handling of the widget is not possible. + \li Due to Apple's design, mouse tracking on the widget currently does not work. - \o Connecting the triggered() signal to a slot that opens a modal + \li Connecting the triggered() signal to a slot that opens a modal dialog will cause a crash in Mac OS X 10.4 (known bug acknowledged by Apple), a workaround is to use a QueuedConnection instead of a DirectConnection. diff --git a/src/widgets/styles/qmacstyle.qdoc b/src/widgets/styles/qmacstyle.qdoc index d48a65c41f..dc8da491bf 100644 --- a/src/widgets/styles/qmacstyle.qdoc +++ b/src/widgets/styles/qmacstyle.qdoc @@ -49,21 +49,21 @@ \list - \i Layout - The restrictions on window layout are such that some + \li Layout - The restrictions on window layout are such that some aspects of layout that are style-dependent cannot be achieved using QLayout. Changes are being considered (and feedback would be appreciated) to make layouts QStyle-able. Some of the restrictions involve horizontal and vertical widget alignment and widget size (covered below). - \i Widget size - Mac OS X allows widgets to have specific fixed sizes. Qt + \li Widget size - Mac OS X allows widgets to have specific fixed sizes. Qt does not fully implement this behavior so as to maintain cross-platform compatibility. As a result some widgets sizes may be inappropriate (and subsequently not rendered correctly by the HITheme APIs).The QWidget::sizeHint() will return the appropriate size for many managed widgets (widgets enumerated in \l QStyle::ContentsType). - \i Effects - QMacStyle uses HITheme for performing most of the drawing, but + \li Effects - QMacStyle uses HITheme for performing most of the drawing, but also uses emulation in a few cases where HITheme does not provide the required functionality (for example, tab bars on Panther, the toolbar separator, etc). We tried to make the emulation as close to the original as diff --git a/src/widgets/styles/qstyle.cpp b/src/widgets/styles/qstyle.cpp index 3ff5aea0ca..db387fecec 100644 --- a/src/widgets/styles/qstyle.cpp +++ b/src/widgets/styles/qstyle.cpp @@ -124,10 +124,10 @@ static int unpackControlTypes(QSizePolicy::ControlTypes controls, QSizePolicy::C Most QStyle draw functions take four arguments: \list - \o an enum value specifying which graphical element to draw - \o a QStyleOption specifying how and where to render that element - \o a QPainter that should be used to draw the element - \o a QWidget on which the drawing is performed (optional) + \li an enum value specifying which graphical element to draw + \li a QStyleOption specifying how and where to render that element + \li a QPainter that should be used to draw the element + \li a QWidget on which the drawing is performed (optional) \endlist For example, if you want to draw a focus rectangle on your @@ -275,12 +275,12 @@ static int unpackControlTypes(QSizePolicy::ControlTypes controls, QSizePolicy::C right-to-left environment: \list - \o subControlRect() and subElementRect() return rectangles in screen coordinates - \o QStyleOption::direction indicates in which direction the item should be drawn in - \o If a style is not right-to-left aware it will display items as if it were left-to-right - \o visualRect(), visualPos(), and visualAlignment() are helpful functions that will + \li subControlRect() and subElementRect() return rectangles in screen coordinates + \li QStyleOption::direction indicates in which direction the item should be drawn in + \li If a style is not right-to-left aware it will display items as if it were left-to-right + \li visualRect(), visualPos(), and visualAlignment() are helpful functions that will translate from logical to screen representations. - \o alignedRect() will return a logical rect aligned for the current direction + \li alignedRect() will return a logical rect aligned for the current direction \endlist \section1 Styles in Item Views @@ -731,50 +731,50 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, it uses a plain QStyleOption object. \table - \header \o Primitive Element \o QStyleOption Subclass \o Style Flag \o Remark - \row \o \l PE_FrameFocusRect \o \l QStyleOptionFocusRect - \o \l State_FocusAtBorder - \o Whether the focus is is at the border or inside the widget. - \row \o{1,2} \l PE_IndicatorCheckBox \o{1,2} \l QStyleOptionButton - \o \l State_NoChange \o Indicates a "tri-state" checkbox. - \row \o \l State_On \o Indicates the indicator is checked. - \row \o \l PE_IndicatorRadioButton \o \l QStyleOptionButton - \o \l State_On \o Indicates that a radio button is selected. - \row \o{1,3} \l PE_Q3CheckListExclusiveIndicator, \l PE_Q3CheckListIndicator - \o{1,3} \l QStyleOptionQ3ListView \o \l State_On - \o Indicates whether or not the controller is selected. - \row \o \l State_NoChange \o Indicates a "tri-state" controller. - \row \o \l State_Enabled \o Indicates the controller is enabled. - \row \o{1,4} \l PE_IndicatorBranch \o{1,4} \l QStyleOption - \o \l State_Children \o Indicates that the control for expanding the tree to show child items, should be drawn. - \row \o \l State_Item \o Indicates that a horizontal branch (to show a child item), should be drawn. - \row \o \l State_Open \o Indicates that the tree branch is expanded. - \row \o \l State_Sibling \o Indicates that a vertical line (to show a sibling item), should be drawn. - \row \o \l PE_IndicatorHeaderArrow \o \l QStyleOptionHeader - \o \l State_UpArrow \o Indicates that the arrow should be drawn up; + \header \li Primitive Element \li QStyleOption Subclass \li Style Flag \li Remark + \row \li \l PE_FrameFocusRect \li \l QStyleOptionFocusRect + \li \l State_FocusAtBorder + \li Whether the focus is is at the border or inside the widget. + \row \li{1,2} \l PE_IndicatorCheckBox \li{1,2} \l QStyleOptionButton + \li \l State_NoChange \li Indicates a "tri-state" checkbox. + \row \li \l State_On \li Indicates the indicator is checked. + \row \li \l PE_IndicatorRadioButton \li \l QStyleOptionButton + \li \l State_On \li Indicates that a radio button is selected. + \row \li{1,3} \l PE_Q3CheckListExclusiveIndicator, \l PE_Q3CheckListIndicator + \li{1,3} \l QStyleOptionQ3ListView \li \l State_On + \li Indicates whether or not the controller is selected. + \row \li \l State_NoChange \li Indicates a "tri-state" controller. + \row \li \l State_Enabled \li Indicates the controller is enabled. + \row \li{1,4} \l PE_IndicatorBranch \li{1,4} \l QStyleOption + \li \l State_Children \li Indicates that the control for expanding the tree to show child items, should be drawn. + \row \li \l State_Item \li Indicates that a horizontal branch (to show a child item), should be drawn. + \row \li \l State_Open \li Indicates that the tree branch is expanded. + \row \li \l State_Sibling \li Indicates that a vertical line (to show a sibling item), should be drawn. + \row \li \l PE_IndicatorHeaderArrow \li \l QStyleOptionHeader + \li \l State_UpArrow \li Indicates that the arrow should be drawn up; otherwise it should be down. - \row \o \l PE_FrameGroupBox, \l PE_Frame, \l PE_FrameLineEdit, + \row \li \l PE_FrameGroupBox, \l PE_Frame, \l PE_FrameLineEdit, \l PE_FrameMenu, \l PE_FrameDockWidget, \l PE_FrameWindow - \o \l QStyleOptionFrame \o \l State_Sunken - \o Indicates that the Frame should be sunken. - \row \o \l PE_IndicatorToolBarHandle \o \l QStyleOption - \o \l State_Horizontal \o Indicates that the window handle is horizontal + \li \l QStyleOptionFrame \li \l State_Sunken + \li Indicates that the Frame should be sunken. + \row \li \l PE_IndicatorToolBarHandle \li \l QStyleOption + \li \l State_Horizontal \li Indicates that the window handle is horizontal instead of vertical. - \row \o \l PE_Q3DockWindowSeparator \o \l QStyleOption - \o \l State_Horizontal \o Indicates that the separator is horizontal + \row \li \l PE_Q3DockWindowSeparator \li \l QStyleOption + \li \l State_Horizontal \li Indicates that the separator is horizontal instead of vertical. - \row \o \l PE_IndicatorSpinPlus, \l PE_IndicatorSpinMinus, \l PE_IndicatorSpinUp, + \row \li \l PE_IndicatorSpinPlus, \l PE_IndicatorSpinMinus, \l PE_IndicatorSpinUp, \l PE_IndicatorSpinDown, - \o \l QStyleOptionSpinBox - \o \l State_Sunken \o Indicates that the button is pressed. - \row \o{1,5} \l PE_PanelButtonCommand - \o{1,5} \l QStyleOptionButton - \o \l State_Enabled \o Set if the button is enabled. - \row \o \l State_HasFocus \o Set if the button has input focus. - \row \o \l State_Raised \o Set if the button is not down, not on and not flat. - \row \o \l State_On \o Set if the button is a toggle button and is toggled on. - \row \o \l State_Sunken - \o Set if the button is down (i.e., the mouse button or the + \li \l QStyleOptionSpinBox + \li \l State_Sunken \li Indicates that the button is pressed. + \row \li{1,5} \l PE_PanelButtonCommand + \li{1,5} \l QStyleOptionButton + \li \l State_Enabled \li Set if the button is enabled. + \row \li \l State_HasFocus \li Set if the button has input focus. + \row \li \l State_Raised \li Set if the button is not down, not on and not flat. + \row \li \l State_On \li Set if the button is a toggle button and is toggled on. + \row \li \l State_Sunken + \li Set if the button is down (i.e., the mouse button or the space bar is pressed on the button). \endtable @@ -887,69 +887,69 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, it uses a plain QStyleOption object. \table - \header \o Control Element \o QStyleOption Subclass \o Style Flag \o Remark - \row \o{1,5} \l CE_MenuItem, \l CE_MenuBarItem - \o{1,5} \l QStyleOptionMenuItem - \o \l State_Selected \o The menu item is currently selected item. - \row \o \l State_Enabled \o The item is enabled. - \row \o \l State_DownArrow \o Indicates that a scroll down arrow should be drawn. - \row \o \l State_UpArrow \o Indicates that a scroll up arrow should be drawn - \row \o \l State_HasFocus \o Set if the menu bar has input focus. - - \row \o{1,5} \l CE_PushButton, \l CE_PushButtonBevel, \l CE_PushButtonLabel - \o{1,5} \l QStyleOptionButton - \o \l State_Enabled \o Set if the button is enabled. - \row \o \l State_HasFocus \o Set if the button has input focus. - \row \o \l State_Raised \o Set if the button is not down, not on and not flat. - \row \o \l State_On \o Set if the button is a toggle button and is toggled on. - \row \o \l State_Sunken - \o Set if the button is down (i.e., the mouse button or the + \header \li Control Element \li QStyleOption Subclass \li Style Flag \li Remark + \row \li{1,5} \l CE_MenuItem, \l CE_MenuBarItem + \li{1,5} \l QStyleOptionMenuItem + \li \l State_Selected \li The menu item is currently selected item. + \row \li \l State_Enabled \li The item is enabled. + \row \li \l State_DownArrow \li Indicates that a scroll down arrow should be drawn. + \row \li \l State_UpArrow \li Indicates that a scroll up arrow should be drawn + \row \li \l State_HasFocus \li Set if the menu bar has input focus. + + \row \li{1,5} \l CE_PushButton, \l CE_PushButtonBevel, \l CE_PushButtonLabel + \li{1,5} \l QStyleOptionButton + \li \l State_Enabled \li Set if the button is enabled. + \row \li \l State_HasFocus \li Set if the button has input focus. + \row \li \l State_Raised \li Set if the button is not down, not on and not flat. + \row \li \l State_On \li Set if the button is a toggle button and is toggled on. + \row \li \l State_Sunken + \li Set if the button is down (i.e., the mouse button or the space bar is pressed on the button). - \row \o{1,6} \l CE_RadioButton, \l CE_RadioButtonLabel, + \row \li{1,6} \l CE_RadioButton, \l CE_RadioButtonLabel, \l CE_CheckBox, \l CE_CheckBoxLabel - \o{1,6} \l QStyleOptionButton - \o \l State_Enabled \o Set if the button is enabled. - \row \o \l State_HasFocus \o Set if the button has input focus. - \row \o \l State_On \o Set if the button is checked. - \row \o \l State_Off \o Set if the button is not checked. - \row \o \l State_NoChange \o Set if the button is in the NoChange state. - \row \o \l State_Sunken - \o Set if the button is down (i.e., the mouse button or + \li{1,6} \l QStyleOptionButton + \li \l State_Enabled \li Set if the button is enabled. + \row \li \l State_HasFocus \li Set if the button has input focus. + \row \li \l State_On \li Set if the button is checked. + \row \li \l State_Off \li Set if the button is not checked. + \row \li \l State_NoChange \li Set if the button is in the NoChange state. + \row \li \l State_Sunken + \li Set if the button is down (i.e., the mouse button or the space bar is pressed on the button). - \row \o{1,2} \l CE_ProgressBarContents, \l CE_ProgressBarLabel, + \row \li{1,2} \l CE_ProgressBarContents, \l CE_ProgressBarLabel, \l CE_ProgressBarGroove - \o{1,2} \l QStyleOptionProgressBar - \o \l State_Enabled \o Set if the progress bar is enabled. - \row \o \l State_HasFocus \o Set if the progress bar has input focus. - - \row \o \l CE_Header, \l CE_HeaderSection, \l CE_HeaderLabel \o \l QStyleOptionHeader \o \o - - \row \o{1,3} \l CE_TabBarTab, CE_TabBarTabShape, CE_TabBarTabLabel - \o{1,3} \l QStyleOptionTab - \o \l State_Enabled \o Set if the tab bar is enabled. - \row \o \l State_Selected \o The tab bar is the currently selected tab bar. - \row \o \l State_HasFocus \o Set if the tab bar tab has input focus. - - \row \o{1,7} \l CE_ToolButtonLabel - \o{1,7} \l QStyleOptionToolButton - \o \l State_Enabled \o Set if the tool button is enabled. - \row \o \l State_HasFocus \o Set if the tool button has input focus. - \row \o \l State_Sunken - \o Set if the tool button is down (i.e., a mouse button or + \li{1,2} \l QStyleOptionProgressBar + \li \l State_Enabled \li Set if the progress bar is enabled. + \row \li \l State_HasFocus \li Set if the progress bar has input focus. + + \row \li \l CE_Header, \l CE_HeaderSection, \l CE_HeaderLabel \li \l QStyleOptionHeader \li \li + + \row \li{1,3} \l CE_TabBarTab, CE_TabBarTabShape, CE_TabBarTabLabel + \li{1,3} \l QStyleOptionTab + \li \l State_Enabled \li Set if the tab bar is enabled. + \row \li \l State_Selected \li The tab bar is the currently selected tab bar. + \row \li \l State_HasFocus \li Set if the tab bar tab has input focus. + + \row \li{1,7} \l CE_ToolButtonLabel + \li{1,7} \l QStyleOptionToolButton + \li \l State_Enabled \li Set if the tool button is enabled. + \row \li \l State_HasFocus \li Set if the tool button has input focus. + \row \li \l State_Sunken + \li Set if the tool button is down (i.e., a mouse button or the space bar is pressed). - \row \o \l State_On \o Set if the tool button is a toggle button and is toggled on. - \row \o \l State_AutoRaise \o Set if the tool button has auto-raise enabled. - \row \o \l State_MouseOver \o Set if the mouse pointer is over the tool button. - \row \o \l State_Raised \o Set if the button is not down and is not on. - - \row \o \l CE_ToolBoxTab \o \l QStyleOptionToolBox - \o \l State_Selected \o The tab is the currently selected tab. - \row \o{1,3} \l CE_HeaderSection \o{1,3} \l QStyleOptionHeader - \o \l State_Sunken \o Indicates that the section is pressed. - \row \o \l State_UpArrow \o Indicates that the sort indicator should be pointing up. - \row \o \l State_DownArrow \o Indicates that the sort indicator should be pointing down. + \row \li \l State_On \li Set if the tool button is a toggle button and is toggled on. + \row \li \l State_AutoRaise \li Set if the tool button has auto-raise enabled. + \row \li \l State_MouseOver \li Set if the mouse pointer is over the tool button. + \row \li \l State_Raised \li Set if the button is not down and is not on. + + \row \li \l CE_ToolBoxTab \li \l QStyleOptionToolBox + \li \l State_Selected \li The tab is the currently selected tab. + \row \li{1,3} \l CE_HeaderSection \li{1,3} \l QStyleOptionHeader + \li \l State_Sunken \li Indicates that the section is pressed. + \row \li \l State_UpArrow \li Indicates that the sort indicator should be pointing up. + \row \li \l State_DownArrow \li Indicates that the sort indicator should be pointing down. \endtable \sa drawPrimitive(), drawComplexControl() @@ -1077,20 +1077,20 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, table below for the appropriate \a option casts: \table - \header \o Sub Element \o QStyleOption Subclass - \row \o \l SE_PushButtonContents \o \l QStyleOptionButton - \row \o \l SE_PushButtonFocusRect \o \l QStyleOptionButton - \row \o \l SE_CheckBoxIndicator \o \l QStyleOptionButton - \row \o \l SE_CheckBoxContents \o \l QStyleOptionButton - \row \o \l SE_CheckBoxFocusRect \o \l QStyleOptionButton - \row \o \l SE_RadioButtonIndicator \o \l QStyleOptionButton - \row \o \l SE_RadioButtonContents \o \l QStyleOptionButton - \row \o \l SE_RadioButtonFocusRect \o \l QStyleOptionButton - \row \o \l SE_ComboBoxFocusRect \o \l QStyleOptionComboBox - \row \o \l SE_Q3DockWindowHandleRect \o \l QStyleOptionQ3DockWindow - \row \o \l SE_ProgressBarGroove \o \l QStyleOptionProgressBar - \row \o \l SE_ProgressBarContents \o \l QStyleOptionProgressBar - \row \o \l SE_ProgressBarLabel \o \l QStyleOptionProgressBar + \header \li Sub Element \li QStyleOption Subclass + \row \li \l SE_PushButtonContents \li \l QStyleOptionButton + \row \li \l SE_PushButtonFocusRect \li \l QStyleOptionButton + \row \li \l SE_CheckBoxIndicator \li \l QStyleOptionButton + \row \li \l SE_CheckBoxContents \li \l QStyleOptionButton + \row \li \l SE_CheckBoxFocusRect \li \l QStyleOptionButton + \row \li \l SE_RadioButtonIndicator \li \l QStyleOptionButton + \row \li \l SE_RadioButtonContents \li \l QStyleOptionButton + \row \li \l SE_RadioButtonFocusRect \li \l QStyleOptionButton + \row \li \l SE_ComboBoxFocusRect \li \l QStyleOptionComboBox + \row \li \l SE_Q3DockWindowHandleRect \li \l QStyleOptionQ3DockWindow + \row \li \l SE_ProgressBarGroove \li \l QStyleOptionProgressBar + \row \li \l SE_ProgressBarContents \li \l QStyleOptionProgressBar + \row \li \l SE_ProgressBarLabel \li \l QStyleOptionProgressBar \endtable */ @@ -1222,43 +1222,43 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, appropriate subclass. \table - \header \o Complex Control \o QStyleOptionComplex Subclass \o Style Flag \o Remark - \row \o{1,2} \l{CC_SpinBox} \o{1,2} \l QStyleOptionSpinBox - \o \l State_Enabled \o Set if the spin box is enabled. - \row \o \l State_HasFocus \o Set if the spin box has input focus. - - \row \o{1,2} \l {CC_ComboBox} \o{1,2} \l QStyleOptionComboBox - \o \l State_Enabled \o Set if the combobox is enabled. - \row \o \l State_HasFocus \o Set if the combobox has input focus. - - \row \o{1,2} \l {CC_ScrollBar} \o{1,2} \l QStyleOptionSlider - \o \l State_Enabled \o Set if the scroll bar is enabled. - \row \o \l State_HasFocus \o Set if the scroll bar has input focus. - - \row \o{1,2} \l {CC_Slider} \o{1,2} \l QStyleOptionSlider - \o \l State_Enabled \o Set if the slider is enabled. - \row \o \l State_HasFocus \o Set if the slider has input focus. - - \row \o{1,2} \l {CC_Dial} \o{1,2} \l QStyleOptionSlider - \o \l State_Enabled \o Set if the dial is enabled. - \row \o \l State_HasFocus \o Set if the dial has input focus. - - \row \o{1,6} \l {CC_ToolButton} \o{1,6} \l QStyleOptionToolButton - \o \l State_Enabled \o Set if the tool button is enabled. - \row \o \l State_HasFocus \o Set if the tool button has input focus. - \row \o \l State_DownArrow \o Set if the tool button is down (i.e., a mouse + \header \li Complex Control \li QStyleOptionComplex Subclass \li Style Flag \li Remark + \row \li{1,2} \l{CC_SpinBox} \li{1,2} \l QStyleOptionSpinBox + \li \l State_Enabled \li Set if the spin box is enabled. + \row \li \l State_HasFocus \li Set if the spin box has input focus. + + \row \li{1,2} \l {CC_ComboBox} \li{1,2} \l QStyleOptionComboBox + \li \l State_Enabled \li Set if the combobox is enabled. + \row \li \l State_HasFocus \li Set if the combobox has input focus. + + \row \li{1,2} \l {CC_ScrollBar} \li{1,2} \l QStyleOptionSlider + \li \l State_Enabled \li Set if the scroll bar is enabled. + \row \li \l State_HasFocus \li Set if the scroll bar has input focus. + + \row \li{1,2} \l {CC_Slider} \li{1,2} \l QStyleOptionSlider + \li \l State_Enabled \li Set if the slider is enabled. + \row \li \l State_HasFocus \li Set if the slider has input focus. + + \row \li{1,2} \l {CC_Dial} \li{1,2} \l QStyleOptionSlider + \li \l State_Enabled \li Set if the dial is enabled. + \row \li \l State_HasFocus \li Set if the dial has input focus. + + \row \li{1,6} \l {CC_ToolButton} \li{1,6} \l QStyleOptionToolButton + \li \l State_Enabled \li Set if the tool button is enabled. + \row \li \l State_HasFocus \li Set if the tool button has input focus. + \row \li \l State_DownArrow \li Set if the tool button is down (i.e., a mouse button or the space bar is pressed). - \row \o \l State_On \o Set if the tool button is a toggle button + \row \li \l State_On \li Set if the tool button is a toggle button and is toggled on. - \row \o \l State_AutoRaise \o Set if the tool button has auto-raise enabled. - \row \o \l State_Raised \o Set if the button is not down, not on, and doesn't + \row \li \l State_AutoRaise \li Set if the tool button has auto-raise enabled. + \row \li \l State_Raised \li Set if the button is not down, not on, and doesn't contain the mouse when auto-raise is enabled. - \row \o \l{CC_TitleBar} \o \l QStyleOptionTitleBar - \o \l State_Enabled \o Set if the title bar is enabled. + \row \li \l{CC_TitleBar} \li \l QStyleOptionTitleBar + \li \l State_Enabled \li Set if the title bar is enabled. - \row \o \l{CC_Q3ListView} \o \l QStyleOptionQ3ListView - \o \l State_Enabled \o Set if the list view is enabled. + \row \li \l{CC_Q3ListView} \li \l QStyleOptionQ3ListView + \li \l State_Enabled \li Set if the list view is enabled. \endtable @@ -1492,17 +1492,17 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, for the appropriate \a option casts: \table - \header \o Pixel Metric \o QStyleOption Subclass - \row \o \l PM_SliderControlThickness \o \l QStyleOptionSlider - \row \o \l PM_SliderLength \o \l QStyleOptionSlider - \row \o \l PM_SliderTickmarkOffset \o \l QStyleOptionSlider - \row \o \l PM_SliderSpaceAvailable \o \l QStyleOptionSlider - \row \o \l PM_ScrollBarExtent \o \l QStyleOptionSlider - \row \o \l PM_TabBarTabOverlap \o \l QStyleOptionTab - \row \o \l PM_TabBarTabHSpace \o \l QStyleOptionTab - \row \o \l PM_TabBarTabVSpace \o \l QStyleOptionTab - \row \o \l PM_TabBarBaseHeight \o \l QStyleOptionTab - \row \o \l PM_TabBarBaseOverlap \o \l QStyleOptionTab + \header \li Pixel Metric \li QStyleOption Subclass + \row \li \l PM_SliderControlThickness \li \l QStyleOptionSlider + \row \li \l PM_SliderLength \li \l QStyleOptionSlider + \row \li \l PM_SliderTickmarkOffset \li \l QStyleOptionSlider + \row \li \l PM_SliderSpaceAvailable \li \l QStyleOptionSlider + \row \li \l PM_ScrollBarExtent \li \l QStyleOptionSlider + \row \li \l PM_TabBarTabOverlap \li \l QStyleOptionTab + \row \li \l PM_TabBarTabHSpace \li \l QStyleOptionTab + \row \li \l PM_TabBarTabVSpace \li \l QStyleOptionTab + \row \li \l PM_TabBarBaseHeight \li \l QStyleOptionTab + \row \li \l PM_TabBarBaseOverlap \li \l QStyleOptionTab \endtable Some pixel metrics are called from widgets and some are only called @@ -1568,16 +1568,16 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, See the table below for the appropriate \a option casts: \table - \header \o Contents Type \o QStyleOption Subclass - \row \o \l CT_PushButton \o \l QStyleOptionButton - \row \o \l CT_CheckBox \o \l QStyleOptionButton - \row \o \l CT_RadioButton \o \l QStyleOptionButton - \row \o \l CT_ToolButton \o \l QStyleOptionToolButton - \row \o \l CT_ComboBox \o \l QStyleOptionComboBox - \row \o \l CT_Splitter \o \l QStyleOption - \row \o \l CT_Q3DockWindow \o \l QStyleOptionQ3DockWindow - \row \o \l CT_ProgressBar \o \l QStyleOptionProgressBar - \row \o \l CT_MenuItem \o \l QStyleOptionMenuItem + \header \li Contents Type \li QStyleOption Subclass + \row \li \l CT_PushButton \li \l QStyleOptionButton + \row \li \l CT_CheckBox \li \l QStyleOptionButton + \row \li \l CT_RadioButton \li \l QStyleOptionButton + \row \li \l CT_ToolButton \li \l QStyleOptionToolButton + \row \li \l CT_ComboBox \li \l QStyleOptionComboBox + \row \li \l CT_Splitter \li \l QStyleOption + \row \li \l CT_Q3DockWindow \li \l QStyleOptionQ3DockWindow + \row \li \l CT_ProgressBar \li \l QStyleOptionProgressBar + \row \li \l CT_MenuItem \li \l QStyleOptionMenuItem \endtable \sa ContentsType QStyleOption diff --git a/src/widgets/styles/qstyleoption.cpp b/src/widgets/styles/qstyleoption.cpp index 63e7b8775e..d72ba1bac5 100644 --- a/src/widgets/styles/qstyleoption.cpp +++ b/src/widgets/styles/qstyleoption.cpp @@ -1795,7 +1795,7 @@ QStyleOptionMenuItem::QStyleOptionMenuItem(int version) \brief the text for the menu item Note that the text format is something like this "Menu - text\bold{\\t}Shortcut". + text\b{\\t}Shortcut". If the menu item doesn't have a shortcut, it will just contain the menu item's text. The default value is an empty string. @@ -2240,7 +2240,7 @@ QStyleOptionSpinBox::QStyleOptionSpinBox(int version) \inmodule QtWidgets This class is used for drawing the compatibility Q3ListView's - items. \bold {It is not recommended for new classes}. + items. \b {It is not recommended for new classes}. QStyleOptionQ3ListViewItem contains all the information that QStyle functions need to draw the Q3ListView items. @@ -2376,7 +2376,7 @@ QStyleOptionQ3ListViewItem::QStyleOptionQ3ListViewItem(int version) \inmodule QtWidgets - This class is used for drawing the compatibility Q3ListView. \bold + This class is used for drawing the compatibility Q3ListView. \b {It is not recommended for new classes}. QStyleOptionQ3ListView contains all the information that QStyle @@ -2523,7 +2523,7 @@ QStyleOptionQ3ListView::QStyleOptionQ3ListView(int version) \inmodule QtWidgets This class is used for drawing the old Q3DockWindow and its - parts. \bold {It is not recommended for new classes}. + parts. \b {It is not recommended for new classes}. QStyleOptionQ3DockWindow contains all the information that QStyle functions need to draw Q3DockWindow and its parts. diff --git a/src/widgets/util/qcompleter.cpp b/src/widgets/util/qcompleter.cpp index d416f26f51..91e4a9c3c1 100644 --- a/src/widgets/util/qcompleter.cpp +++ b/src/widgets/util/qcompleter.cpp @@ -1475,7 +1475,7 @@ int QCompleter::completionCount() const The sort order (i.e ascending or descending order) of the model is determined dynamically by inspecting the contents of the model. - \bold{Note:} The performance improvements described above cannot take place + \b{Note:} The performance improvements described above cannot take place when the completer's \l caseSensitivity is different to the case sensitivity used by the model's when sorting. diff --git a/src/widgets/util/qscrollerproperties.cpp b/src/widgets/util/qscrollerproperties.cpp index 8d6ad36014..b698252b07 100644 --- a/src/widgets/util/qscrollerproperties.cpp +++ b/src/widgets/util/qscrollerproperties.cpp @@ -329,7 +329,7 @@ void QScrollerProperties::setScrollMetric(ScrollMetric metric, const QVariant &v around the axis. The threshold must be in the range \c 0 to \c 1. \value ScrollingCurve The QEasingCurve used when decelerating the scrolling velocity after an - user initiated flick. Please note that this is the easing curve for the positions, \bold{not} + user initiated flick. Please note that this is the easing curve for the positions, \b{not} the velocity: the default is QEasingCurve::OutQuad, which results in a linear decrease in velocity (1st derivative) and a constant deceleration (2nd derivative). diff --git a/src/widgets/util/qsystemtrayicon.cpp b/src/widgets/util/qsystemtrayicon.cpp index bed8dc2eae..fc2d046114 100644 --- a/src/widgets/util/qsystemtrayicon.cpp +++ b/src/widgets/util/qsystemtrayicon.cpp @@ -77,10 +77,10 @@ QT_BEGIN_NAMESPACE The QSystemTrayIcon class can be used on the following platforms: \list - \o All supported versions of Windows. - \o All window managers for X11 that implement the \l{freedesktop.org} system + \li All supported versions of Windows. + \li All window managers for X11 that implement the \l{freedesktop.org} system tray specification, including recent versions of KDE and GNOME. - \o All supported versions of Mac OS X. Note that the Growl + \li All supported versions of Mac OS X. Note that the Growl notification system must be installed for QSystemTrayIcon::showMessage() to display messages. \endlist diff --git a/src/widgets/util/qundostack.cpp b/src/widgets/util/qundostack.cpp index 7cd77678e6..5392dd2f8e 100644 --- a/src/widgets/util/qundostack.cpp +++ b/src/widgets/util/qundostack.cpp @@ -934,10 +934,10 @@ QAction *QUndoStack::createRedoAction(QObject *parent, const QString &prefix) co While a macro is composed, the stack is disabled. This means that: \list - \i indexChanged() and cleanChanged() are not emitted, - \i canUndo() and canRedo() return false, - \i calling undo() or redo() has no effect, - \i the undo/redo actions are disabled. + \li indexChanged() and cleanChanged() are not emitted, + \li canUndo() and canRedo() return false, + \li calling undo() or redo() has no effect, + \li the undo/redo actions are disabled. \endlist The stack becomes enabled and appropriate signals are emitted when endMacro() diff --git a/src/widgets/widgets/qabstractbutton.cpp b/src/widgets/widgets/qabstractbutton.cpp index be250c54e1..2c51e89c43 100644 --- a/src/widgets/widgets/qabstractbutton.cpp +++ b/src/widgets/widgets/qabstractbutton.cpp @@ -109,21 +109,21 @@ Q_WIDGETS_EXPORT extern bool qt_tab_all_widgets; \list - \o isDown() indicates whether the button is \e pressed down. + \li isDown() indicates whether the button is \e pressed down. - \o isChecked() indicates whether the button is \e checked. Only + \li isChecked() indicates whether the button is \e checked. Only checkable buttons can be checked and unchecked (see below). - \o isEnabled() indicates whether the button can be pressed by the + \li isEnabled() indicates whether the button can be pressed by the user. \note As opposed to other widgets, buttons derived from QAbstractButton accepts mouse and context menu events when disabled. - \o setAutoRepeat() sets whether the button will auto-repeat if the + \li setAutoRepeat() sets whether the button will auto-repeat if the user holds it down. \l autoRepeatDelay and \l autoRepeatInterval define how auto-repetition is done. - \o setCheckable() sets whether the button is a toggle button or not. + \li setCheckable() sets whether the button is a toggle button or not. \endlist @@ -138,16 +138,16 @@ Q_WIDGETS_EXPORT extern bool qt_tab_all_widgets; \list 1 - \o pressed() is emitted when the left mouse button is pressed while + \li pressed() is emitted when the left mouse button is pressed while the mouse cursor is inside the button. - \o released() is emitted when the left mouse button is released. + \li released() is emitted when the left mouse button is released. - \o clicked() is emitted when the button is first pressed and then + \li clicked() is emitted when the button is first pressed and then released, when the shortcut key is typed, or when click() or animateClick() is called. - \o toggled() is emitted when the state of a toggle button changes. + \li toggled() is emitted when the state of a toggle button changes. \endlist diff --git a/src/widgets/widgets/qabstractscrollarea.cpp b/src/widgets/widgets/qabstractscrollarea.cpp index 03ec21680d..a960ce8d9c 100644 --- a/src/widgets/widgets/qabstractscrollarea.cpp +++ b/src/widgets/widgets/qabstractscrollarea.cpp @@ -101,14 +101,14 @@ QT_BEGIN_NAMESPACE following: \list - \o Control the scroll bars by setting their + \li Control the scroll bars by setting their range, value, page step, and tracking their movements. - \o Draw the contents of the area in the viewport according + \li Draw the contents of the area in the viewport according to the values of the scroll bars. - \o Handle events received by the viewport in + \li Handle events received by the viewport in viewportEvent() - notably resize events. - \o Use \c{viewport->update()} to update the contents of the + \li Use \c{viewport->update()} to update the contents of the viewport instead of \l{QWidget::update()}{update()} as all painting operations take place on the viewport. \endlist diff --git a/src/widgets/widgets/qabstractslider.cpp b/src/widgets/widgets/qabstractslider.cpp index be193f64f0..6aff2e9077 100644 --- a/src/widgets/widgets/qabstractslider.cpp +++ b/src/widgets/widgets/qabstractslider.cpp @@ -65,23 +65,23 @@ QT_BEGIN_NAMESPACE \list 1 - \i \l value: The bounded integer that QAbstractSlider maintains. + \li \l value: The bounded integer that QAbstractSlider maintains. - \i \l minimum: The lowest possible value. + \li \l minimum: The lowest possible value. - \i \l maximum: The highest possible value. + \li \l maximum: The highest possible value. - \i \l singleStep: The smaller of two natural steps that an + \li \l singleStep: The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key. - \i \l pageStep: The larger of two natural steps that an abstract + \li \l pageStep: The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown. - \i \l tracking: Whether slider tracking is enabled. + \li \l tracking: Whether slider tracking is enabled. - \i \l sliderPosition: The current position of the slider. If \l + \li \l sliderPosition: The current position of the slider. If \l tracking is enabled (the default), this is identical to \l value. \endlist @@ -95,21 +95,21 @@ QT_BEGIN_NAMESPACE QAbstractSlider emits a comprehensive set of signals: \table - \header \i Signal \i Emitted when - \row \i \l valueChanged() - \i the value has changed. The \l tracking + \header \li Signal \li Emitted when + \row \li \l valueChanged() + \li the value has changed. The \l tracking determines whether this signal is emitted during user interaction. - \row \i \l sliderPressed() - \i the user starts to drag the slider. - \row \i \l sliderMoved() - \i the user drags the slider. - \row \i \l sliderReleased() - \i the user releases the slider. - \row \i \l actionTriggered() - \i a slider action was triggerd. - \row \i \l rangeChanged() - \i a the range has changed. + \row \li \l sliderPressed() + \li the user starts to drag the slider. + \row \li \l sliderMoved() + \li the user drags the slider. + \row \li \l sliderReleased() + \li the user releases the slider. + \row \li \l actionTriggered() + \li a slider action was triggerd. + \row \li \l rangeChanged() + \li a the range has changed. \endtable QAbstractSlider provides a virtual sliderChange() function that is diff --git a/src/widgets/widgets/qabstractspinbox.cpp b/src/widgets/widgets/qabstractspinbox.cpp index 331b4918bd..e9652a9869 100644 --- a/src/widgets/widgets/qabstractspinbox.cpp +++ b/src/widgets/widgets/qabstractspinbox.cpp @@ -90,11 +90,11 @@ QT_BEGIN_NAMESPACE \list 1 - \i \l text: The text that is displayed in the QAbstractSpinBox. + \li \l text: The text that is displayed in the QAbstractSpinBox. - \i \l alignment: The alignment of the text in the QAbstractSpinBox. + \li \l alignment: The alignment of the text in the QAbstractSpinBox. - \i \l wrapping: Whether the QAbstractSpinBox wraps from the + \li \l wrapping: Whether the QAbstractSpinBox wraps from the minimum value to the maximum value and vica versa. \endlist @@ -167,7 +167,7 @@ QAbstractSpinBox::~QAbstractSpinBox() \inlineimage qspinbox-plusminus.png \value UpDownArrows Little arrows in the classic style. - \value PlusMinus \bold{+} and \bold{-} symbols. + \value PlusMinus \b{+} and \b{-} symbols. \value NoButtons Don't display buttons. \sa QAbstractSpinBox::buttonSymbols @@ -918,17 +918,17 @@ void QAbstractSpinBox::paintEvent(QPaintEvent *) The following keys are handled specifically: \table - \row \i Enter/Return - \i This will reinterpret the text and emit a signal even if the value has not changed + \row \li Enter/Return + \li This will reinterpret the text and emit a signal even if the value has not changed since last time a signal was emitted. - \row \i Up - \i This will invoke stepBy(1) - \row \i Down - \i This will invoke stepBy(-1) - \row \i Page up - \i This will invoke stepBy(10) - \row \i Page down - \i This will invoke stepBy(-10) + \row \li Up + \li This will invoke stepBy(1) + \row \li Down + \li This will invoke stepBy(-1) + \row \li Page up + \li This will invoke stepBy(10) + \row \li Page down + \li This will invoke stepBy(-10) \endtable */ diff --git a/src/widgets/widgets/qcalendarwidget.cpp b/src/widgets/widgets/qcalendarwidget.cpp index 1541010646..129da9d94d 100644 --- a/src/widgets/widgets/qcalendarwidget.cpp +++ b/src/widgets/widgets/qcalendarwidget.cpp @@ -2001,9 +2001,9 @@ void QCalendarWidgetPrivate::_q_editingFinished() setGridVisible() function: \table - \row \o + \row \li \image qcalendarwidget-grid.png - \row \o + \row \li \snippet doc/src/snippets/code/src_gui_widgets_qcalendarwidget.cpp 0 \endtable @@ -2418,9 +2418,9 @@ void QCalendarWidget::showToday() \table \row - \o \image qcalendarwidget-minimum.png + \li \image qcalendarwidget-minimum.png \row - \o + \li \snippet doc/src/snippets/code/src_gui_widgets_qcalendarwidget.cpp 1 \endtable @@ -2469,9 +2469,9 @@ void QCalendarWidget::setMinimumDate(const QDate &date) \table \row - \o \image qcalendarwidget-maximum.png + \li \image qcalendarwidget-maximum.png \row - \o + \li \snippet doc/src/snippets/code/src_gui_widgets_qcalendarwidget.cpp 2 \endtable @@ -2638,9 +2638,9 @@ void QCalendarWidget::setVerticalHeaderFormat(QCalendarWidget::VerticalHeaderFor \table \row - \o \inlineimage qcalendarwidget-grid.png + \li \inlineimage qcalendarwidget-grid.png \row - \o + \li \snippet doc/src/snippets/code/src_gui_widgets_qcalendarwidget.cpp 5 \endtable diff --git a/src/widgets/widgets/qcheckbox.cpp b/src/widgets/widgets/qcheckbox.cpp index 3bf2e39ef1..13440ac104 100644 --- a/src/widgets/widgets/qcheckbox.cpp +++ b/src/widgets/widgets/qcheckbox.cpp @@ -87,8 +87,8 @@ public: non-exclusive checkboxes. \table - \row \o \inlineimage checkboxes-exclusive.png - \o \inlineimage checkboxes-non-exclusive.png + \row \li \inlineimage checkboxes-exclusive.png + \li \inlineimage checkboxes-non-exclusive.png \endtable Whenever a checkbox is checked or cleared it emits the signal @@ -121,14 +121,14 @@ public: \table 100% \row - \o \inlineimage macintosh-checkbox.png Screenshot of a Macintosh style checkbox - \o A checkbox shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \li \inlineimage macintosh-checkbox.png Screenshot of a Macintosh style checkbox + \li A checkbox shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. \row - \o \inlineimage windows-checkbox.png Screenshot of a Windows XP style checkbox - \o A checkbox shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \li \inlineimage windows-checkbox.png Screenshot of a Windows XP style checkbox + \li A checkbox shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. \row - \o \inlineimage plastique-checkbox.png Screenshot of a Plastique style checkbox - \o A checkbox shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \li \inlineimage plastique-checkbox.png Screenshot of a Plastique style checkbox + \li A checkbox shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QAbstractButton, QRadioButton, {fowler}{GUI Design Handbook: Check Box} diff --git a/src/widgets/widgets/qdatetimeedit.cpp b/src/widgets/widgets/qdatetimeedit.cpp index 5761c1299c..3d0996a9f5 100644 --- a/src/widgets/widgets/qdatetimeedit.cpp +++ b/src/widgets/widgets/qdatetimeedit.cpp @@ -103,12 +103,12 @@ QT_BEGIN_NAMESPACE calendar widget can be retrieved with calendarWidget(). \table 100% - \row \o \inlineimage windowsxp-datetimeedit.png Screenshot of a Windows XP style date time editing widget - \o A date time editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage macintosh-datetimeedit.png Screenshot of a Macintosh style date time editing widget - \o A date time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage plastique-datetimeedit.png Screenshot of a Plastique style date time editing widget - \o A date time editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage windowsxp-datetimeedit.png Screenshot of a Windows XP style date time editing widget + \li A date time editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage macintosh-datetimeedit.png Screenshot of a Macintosh style date time editing widget + \li A date time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage plastique-datetimeedit.png Screenshot of a Plastique style date time editing widget + \li A date time editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QDateEdit, QTimeEdit, QDate, QTime @@ -835,10 +835,10 @@ QString QDateTimeEdit::sectionText(Section section) const Example format strings (assuming that the date is 2nd of July 1969): \table - \header \i Format \i Result - \row \i dd.MM.yyyy \i 02.07.1969 - \row \i MMM d yy \i Jul 2 69 - \row \i MMMM d yy \i July 2 69 + \header \li Format \li Result + \row \li dd.MM.yyyy \li 02.07.1969 + \row \li MMM d yy \li Jul 2 69 + \row \li MMMM d yy \li July 2 69 \endtable Note that if you specify a two digit year, it will be interpreted @@ -1520,22 +1520,22 @@ void QDateTimeEdit::mousePressEvent(QMouseEvent *event) class: \list - \o \l{QDateTimeEdit::time}{time} holds the date displayed by the widget. - \o \l{QDateTimeEdit::minimumTime}{minimumTime} defines the minimum (earliest) time + \li \l{QDateTimeEdit::time}{time} holds the date displayed by the widget. + \li \l{QDateTimeEdit::minimumTime}{minimumTime} defines the minimum (earliest) time that can be set by the user. - \o \l{QDateTimeEdit::maximumTime}{maximumTime} defines the maximum (latest) time + \li \l{QDateTimeEdit::maximumTime}{maximumTime} defines the maximum (latest) time that can be set by the user. - \o \l{QDateTimeEdit::displayFormat}{displayFormat} contains a string that is used + \li \l{QDateTimeEdit::displayFormat}{displayFormat} contains a string that is used to format the time displayed in the widget. \endlist \table 100% - \row \o \inlineimage windowsxp-timeedit.png Screenshot of a Windows XP style time editing widget - \o A time editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage macintosh-timeedit.png Screenshot of a Macintosh style time editing widget - \o A time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage plastique-timeedit.png Screenshot of a Plastique style time editing widget - \o A time editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage windowsxp-timeedit.png Screenshot of a Windows XP style time editing widget + \li A time editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage macintosh-timeedit.png Screenshot of a Macintosh style time editing widget + \li A time editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage plastique-timeedit.png Screenshot of a Plastique style time editing widget + \li A time editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QDateEdit, QDateTimeEdit @@ -1575,22 +1575,22 @@ QTimeEdit::QTimeEdit(const QTime &time, QWidget *parent) class: \list - \o \l{QDateTimeEdit::date}{date} holds the date displayed by the widget. - \o \l{QDateTimeEdit::minimumDate}{minimumDate} defines the minimum (earliest) + \li \l{QDateTimeEdit::date}{date} holds the date displayed by the widget. + \li \l{QDateTimeEdit::minimumDate}{minimumDate} defines the minimum (earliest) date that can be set by the user. - \o \l{QDateTimeEdit::maximumDate}{maximumDate} defines the maximum (latest) date + \li \l{QDateTimeEdit::maximumDate}{maximumDate} defines the maximum (latest) date that can be set by the user. - \o \l{QDateTimeEdit::displayFormat}{displayFormat} contains a string that is used + \li \l{QDateTimeEdit::displayFormat}{displayFormat} contains a string that is used to format the date displayed in the widget. \endlist \table 100% - \row \o \inlineimage windowsxp-dateedit.png Screenshot of a Windows XP style date editing widget - \o A date editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage macintosh-dateedit.png Screenshot of a Macintosh style date editing widget - \o A date editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage plastique-dateedit.png Screenshot of a Plastique style date editing widget - \o A date editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage windowsxp-dateedit.png Screenshot of a Windows XP style date editing widget + \li A date editing widget shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage macintosh-dateedit.png Screenshot of a Macintosh style date editing widget + \li A date editing widget shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage plastique-dateedit.png Screenshot of a Plastique style date editing widget + \li A date editing widget shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QTimeEdit, QDateTimeEdit diff --git a/src/widgets/widgets/qdial.cpp b/src/widgets/widgets/qdial.cpp index 566652b8f5..e3fe390f2a 100644 --- a/src/widgets/widgets/qdial.cpp +++ b/src/widgets/widgets/qdial.cpp @@ -230,10 +230,10 @@ int QDialPrivate::valueFromPoint(const QPoint &p) const \l {QAbstractSlider::pageStep} {pageStep}. \table - \row \o \inlineimage plastique-dial.png Screenshot of a dial in the Plastique widget style - \o \inlineimage windowsxp-dial.png Screenshot of a dial in the Windows XP widget style - \o \inlineimage macintosh-dial.png Screenshot of a dial in the Macintosh widget style - \row \o {3,1} Dials shown in various widget styles (from left to right): + \row \li \inlineimage plastique-dial.png Screenshot of a dial in the Plastique widget style + \li \inlineimage windowsxp-dial.png Screenshot of a dial in the Windows XP widget style + \li \inlineimage macintosh-dial.png Screenshot of a dial in the Macintosh widget style + \row \li {3,1} Dials shown in various widget styles (from left to right): \l{Plastique Style Widget Gallery}{Plastique}, \l{Windows XP Style Widget Gallery}{Windows XP}, \l{Macintosh Style Widget Gallery}{Macintosh}. diff --git a/src/widgets/widgets/qdialogbuttonbox.cpp b/src/widgets/widgets/qdialogbuttonbox.cpp index d1084168a9..14643e77f6 100644 --- a/src/widgets/widgets/qdialogbuttonbox.cpp +++ b/src/widgets/widgets/qdialogbuttonbox.cpp @@ -76,9 +76,9 @@ QT_BEGIN_NAMESPACE Most buttons for a dialog follow certain roles. Such roles include: \list - \o Accepting or rejecting the dialog. - \o Asking for help. - \o Performing actions on the dialog itself (such as resetting fields or + \li Accepting or rejecting the dialog. + \li Asking for help. + \li Performing actions on the dialog itself (such as resetting fields or applying changes). \endlist @@ -104,35 +104,35 @@ QT_BEGIN_NAMESPACE Currently the buttons are laid out in the following way if the button box is horizontal: \table - \row \o \inlineimage buttonbox-gnomelayout-horizontal.png GnomeLayout Horizontal - \o Button box laid out in horizontal GnomeLayout - \row \o \inlineimage buttonbox-kdelayout-horizontal.png KdeLayout Horizontal - \o Button box laid out in horizontal KdeLayout - \row \o \inlineimage buttonbox-maclayout-horizontal.png MacLayout Horizontal - \o Button box laid out in horizontal MacLayout - \row \o \inlineimage buttonbox-winlayout-horizontal.png WinLayout Horizontal - \o Button box laid out in horizontal WinLayout + \row \li \inlineimage buttonbox-gnomelayout-horizontal.png GnomeLayout Horizontal + \li Button box laid out in horizontal GnomeLayout + \row \li \inlineimage buttonbox-kdelayout-horizontal.png KdeLayout Horizontal + \li Button box laid out in horizontal KdeLayout + \row \li \inlineimage buttonbox-maclayout-horizontal.png MacLayout Horizontal + \li Button box laid out in horizontal MacLayout + \row \li \inlineimage buttonbox-winlayout-horizontal.png WinLayout Horizontal + \li Button box laid out in horizontal WinLayout \endtable The buttons are laid out the following way if the button box is vertical: \table - \row \o GnomeLayout - \o KdeLayout - \o MacLayout - \o WinLayout - \row \o \inlineimage buttonbox-gnomelayout-vertical.png GnomeLayout Vertical - \o \inlineimage buttonbox-kdelayout-vertical.png KdeLayout Vertical - \o \inlineimage buttonbox-maclayout-vertical.png MacLayout Vertical - \o \inlineimage buttonbox-winlayout-vertical.png WinLayout Vertical + \row \li GnomeLayout + \li KdeLayout + \li MacLayout + \li WinLayout + \row \li \inlineimage buttonbox-gnomelayout-vertical.png GnomeLayout Vertical + \li \inlineimage buttonbox-kdelayout-vertical.png KdeLayout Vertical + \li \inlineimage buttonbox-maclayout-vertical.png MacLayout Vertical + \li \inlineimage buttonbox-winlayout-vertical.png WinLayout Vertical \endtable Additionally, button boxes that contain only buttons with ActionRole or HelpRole can be considered modeless and have an alternate look on Mac OS X: \table - \row \o modeless horizontal MacLayout - \o \inlineimage buttonbox-mac-modeless-horizontal.png Screenshot of modeless horizontal MacLayout + \row \li modeless horizontal MacLayout + \li \inlineimage buttonbox-mac-modeless-horizontal.png Screenshot of modeless horizontal MacLayout \endtable When a button is clicked in the button box, the clicked() signal is emitted diff --git a/src/widgets/widgets/qdockwidget.cpp b/src/widgets/widgets/qdockwidget.cpp index a90c754cee..e40b109455 100644 --- a/src/widgets/widgets/qdockwidget.cpp +++ b/src/widgets/widgets/qdockwidget.cpp @@ -1538,22 +1538,22 @@ QAction * QDockWidget::toggleViewAction() const Here are some tips for implementing custom title bars: \list - \o Mouse events that are not explicitly handled by the title bar widget + \li Mouse events that are not explicitly handled by the title bar widget must be ignored by calling QMouseEvent::ignore(). These events then propagate to the QDockWidget parent, which handles them in the usual manner, moving when the title bar is dragged, docking and undocking when it is double-clicked, etc. - \o When DockWidgetVerticalTitleBar is set on QDockWidget, the title + \li When DockWidgetVerticalTitleBar is set on QDockWidget, the title bar widget is repositioned accordingly. In resizeEvent(), the title bar should check what orientation it should assume: \snippet doc/src/snippets/code/src_gui_widgets_qdockwidget.cpp 0 - \o The title bar widget must have a valid QWidget::sizeHint() and + \li The title bar widget must have a valid QWidget::sizeHint() and QWidget::minimumSizeHint(). These functions should take into account the current orientation of the title bar. - \o It is not possible to remove a title bar from a dock widget. However, + \li It is not possible to remove a title bar from a dock widget. However, a similar effect can be achieved by setting a default constructed QWidget as the title bar widget. \endlist diff --git a/src/widgets/widgets/qframe.cpp b/src/widgets/widgets/qframe.cpp index cae4137803..29c213f7af 100644 --- a/src/widgets/widgets/qframe.cpp +++ b/src/widgets/widgets/qframe.cpp @@ -97,15 +97,15 @@ inline void QFramePrivate::init() border: \l lineWidth, \l midLineWidth, and \l frameWidth. \list - \o The line width is the width of the frame border. It can be modified + \li The line width is the width of the frame border. It can be modified to customize the frame's appearance. - \o The mid-line width specifies the width of an extra line in the + \li The mid-line width specifies the width of an extra line in the middle of the frame, which uses a third color to obtain a special 3D effect. Notice that a mid-line is only drawn for \l Box, \l HLine and \l VLine frames that are raised or sunken. - \o The frame width is determined by the frame style, and the frameWidth() + \li The frame width is determined by the frame style, and the frameWidth() function is used to obtain the value defined for the style used. \endlist diff --git a/src/widgets/widgets/qgroupbox.cpp b/src/widgets/widgets/qgroupbox.cpp index 17f3a9323a..cf3e14871f 100644 --- a/src/widgets/widgets/qgroupbox.cpp +++ b/src/widgets/widgets/qgroupbox.cpp @@ -172,12 +172,12 @@ void QGroupBoxPrivate::click() \snippet examples/widgets/groupbox/window.cpp 2 \table 100% - \row \o \inlineimage windowsxp-groupbox.png Screenshot of a Windows XP style group box - \o \inlineimage macintosh-groupbox.png Screenshot of a Macintosh style group box - \o \inlineimage plastique-groupbox.png Screenshot of a Plastique style group box - \row \o A \l{Windows XP Style Widget Gallery}{Windows XP style} group box. - \o A \l{Macintosh Style Widget Gallery}{Macintosh style} group box. - \o A \l{Plastique Style Widget Gallery}{Plastique style} group box. + \row \li \inlineimage windowsxp-groupbox.png Screenshot of a Windows XP style group box + \li \inlineimage macintosh-groupbox.png Screenshot of a Macintosh style group box + \li \inlineimage plastique-groupbox.png Screenshot of a Plastique style group box + \row \li A \l{Windows XP Style Widget Gallery}{Windows XP style} group box. + \li A \l{Macintosh Style Widget Gallery}{Macintosh style} group box. + \li A \l{Plastique Style Widget Gallery}{Plastique style} group box. \endtable \sa QButtonGroup, {Group Box Example} @@ -287,9 +287,9 @@ QString QGroupBox::title() const the following list: \list - \i Qt::AlignLeft aligns the title text with the left-hand side of the group box. - \i Qt::AlignRight aligns the title text with the right-hand side of the group box. - \i Qt::AlignHCenter aligns the title text with the horizontal center of the group box. + \li Qt::AlignLeft aligns the title text with the left-hand side of the group box. + \li Qt::AlignRight aligns the title text with the right-hand side of the group box. + \li Qt::AlignHCenter aligns the title text with the horizontal center of the group box. \endlist The default alignment is Qt::AlignLeft. @@ -516,7 +516,7 @@ QSize QGroupBox::minimumSizeHint() const By default, this property is disabled; i.e. group boxes are not flat unless explicitly specified. - \bold{Note:} In some styles, flat and non-flat group boxes have similar + \b{Note:} In some styles, flat and non-flat group boxes have similar representations and may not be as distinguishable as they are in other styles. diff --git a/src/widgets/widgets/qlabel.cpp b/src/widgets/widgets/qlabel.cpp index d23fab4083..82e56f3354 100644 --- a/src/widgets/widgets/qlabel.cpp +++ b/src/widgets/widgets/qlabel.cpp @@ -76,20 +76,20 @@ QT_BEGIN_NAMESPACE A QLabel can contain any of the following content types: \table - \header \o Content \o Setting - \row \o Plain text - \o Pass a QString to setText(). - \row \o Rich text - \o Pass a QString that contains rich text to setText(). - \row \o A pixmap - \o Pass a QPixmap to setPixmap(). - \row \o A movie - \o Pass a QMovie to setMovie(). - \row \o A number - \o Pass an \e int or a \e double to setNum(), which converts + \header \li Content \li Setting + \row \li Plain text + \li Pass a QString to setText(). + \row \li Rich text + \li Pass a QString that contains rich text to setText(). + \row \li A pixmap + \li Pass a QPixmap to setPixmap(). + \row \li A movie + \li Pass a QMovie to setMovie(). + \row \li A number + \li Pass an \e int or a \e double to setNum(), which converts the number to plain text. - \row \o Nothing - \o The same as an empty plain text. This is the default. Set + \row \li Nothing + \li The same as an empty plain text. This is the default. Set by clear(). \endtable @@ -134,14 +134,14 @@ QT_BEGIN_NAMESPACE \table 100% \row - \o \inlineimage macintosh-label.png Screenshot of a Macintosh style label - \o A label shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \li \inlineimage macintosh-label.png Screenshot of a Macintosh style label + \li A label shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. \row - \o \inlineimage plastique-label.png Screenshot of a Plastique style label - \o A label shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \li \inlineimage plastique-label.png Screenshot of a Plastique style label + \li A label shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \row - \o \inlineimage windowsxp-label.png Screenshot of a Windows XP style label - \o A label shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \li \inlineimage windowsxp-label.png Screenshot of a Windows XP style label + \li A label shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. \endtable \sa QLineEdit, QTextEdit, QPixmap, QMovie, @@ -655,7 +655,7 @@ int QLabel::heightForWidth(int w) const QDesktopServices::openUrl() instead of emitting the linkActivated() signal. - \bold{Note:} The textInteractionFlags set on the label need to include + \b{Note:} The textInteractionFlags set on the label need to include either LinksAccessibleByMouse or LinksAccessibleByKeyboard. The default value is false. @@ -723,7 +723,7 @@ Qt::TextInteractionFlags QLabel::textInteractionFlags() const \sa selectedText() - \bold{Note:} The textInteractionFlags set on the label need to include + \b{Note:} The textInteractionFlags set on the label need to include either TextSelectableByMouse or TextSelectableByKeyboard. \since 4.7 @@ -751,7 +751,7 @@ void QLabel::setSelection(int start, int length) \sa selectedText() - \bold{Note:} The textInteractionFlags set on the label need to include + \b{Note:} The textInteractionFlags set on the label need to include either TextSelectableByMouse or TextSelectableByKeyboard. \since 4.7 @@ -775,7 +775,7 @@ bool QLabel::hasSelectedText() const \sa hasSelectedText() - \bold{Note:} The textInteractionFlags set on the label need to include + \b{Note:} The textInteractionFlags set on the label need to include either TextSelectableByMouse or TextSelectableByKeyboard. \since 4.7 @@ -794,7 +794,7 @@ QString QLabel::selectedText() const \sa selectedText() - \bold{Note:} The textInteractionFlags set on the label need to include + \b{Note:} The textInteractionFlags set on the label need to include either TextSelectableByMouse or TextSelectableByKeyboard. \since 4.7 diff --git a/src/widgets/widgets/qlcdnumber.cpp b/src/widgets/widgets/qlcdnumber.cpp index 71e08fdaeb..4639b15834 100644 --- a/src/widgets/widgets/qlcdnumber.cpp +++ b/src/widgets/widgets/qlcdnumber.cpp @@ -108,13 +108,13 @@ public: Sinclair Spectrum\endlink. \table - \row \o \inlineimage motif-lcdnumber.png Screenshot of a Motif style LCD number widget + \row \li \inlineimage motif-lcdnumber.png Screenshot of a Motif style LCD number widget \inlineimage cde-lcdnumber.png Screenshot of a CDE style LCD number widget \inlineimage windows-lcdnumber.png Screenshot of a Windows style LCD number widget \inlineimage windowsxp-lcdnumber.png Screenshot of a Windows XP style LCD number widget \inlineimage macintosh-lcdnumber.png Screenshot of a Macintosh style LCD number widget \inlineimage plastique-lcdnumber.png Screenshot of a Plastique style LCD number widget - \row \o LCD number widgets shown in various widget styles (from left to right): + \row \li LCD number widgets shown in various widget styles (from left to right): \l{Motif Style Widget Gallery}{Motif}, \l{CDE Style Widget Gallery}{CDE}, \l{Windows Style Widget Gallery}{Windows}, \l{Windows XP Style Widget Gallery}{Windows XP}, \l{Macintosh Style Widget Gallery}{Macintosh}, \l{Plastique Style Widget Gallery}{Plastique}. @@ -1184,14 +1184,14 @@ void QLCDNumberPrivate::drawSegment(const QPoint &pos, char segmentNo, QPainter \brief the style of the LCDNumber \table - \header \i Style \i Result - \row \i \c Outline - \i Produces raised segments filled with the background color - \row \i \c Filled + \header \li Style \li Result + \row \li \c Outline + \li Produces raised segments filled with the background color + \row \li \c Filled (this is the default). - \i Produces raised segments filled with the foreground color. - \row \i \c Flat - \i Produces flat segments filled with the foreground color. + \li Produces raised segments filled with the foreground color. + \row \li \c Flat + \li Produces flat segments filled with the foreground color. \endtable \c Outline and \c Filled will additionally use diff --git a/src/widgets/widgets/qlineedit.cpp b/src/widgets/widgets/qlineedit.cpp index 7118881ef2..07843136ff 100644 --- a/src/widgets/widgets/qlineedit.cpp +++ b/src/widgets/widgets/qlineedit.cpp @@ -177,39 +177,39 @@ void QLineEdit::initStyleOption(QStyleOptionFrame *option) const that presents some of these editing options. \target desc \table - \header \i Keypress \i Action - \row \i Left Arrow \i Moves the cursor one character to the left. - \row \i Shift+Left Arrow \i Moves and selects text one character to the left. - \row \i Right Arrow \i Moves the cursor one character to the right. - \row \i Shift+Right Arrow \i Moves and selects text one character to the right. - \row \i Home \i Moves the cursor to the beginning of the line. - \row \i End \i Moves the cursor to the end of the line. - \row \i Backspace \i Deletes the character to the left of the cursor. - \row \i Ctrl+Backspace \i Deletes the word to the left of the cursor. - \row \i Delete \i Deletes the character to the right of the cursor. - \row \i Ctrl+Delete \i Deletes the word to the right of the cursor. - \row \i Ctrl+A \i Select all. - \row \i Ctrl+C \i Copies the selected text to the clipboard. - \row \i Ctrl+Insert \i Copies the selected text to the clipboard. - \row \i Ctrl+K \i Deletes to the end of the line. - \row \i Ctrl+V \i Pastes the clipboard text into line edit. - \row \i Shift+Insert \i Pastes the clipboard text into line edit. - \row \i Ctrl+X \i Deletes the selected text and copies it to the clipboard. - \row \i Shift+Delete \i Deletes the selected text and copies it to the clipboard. - \row \i Ctrl+Z \i Undoes the last operation. - \row \i Ctrl+Y \i Redoes the last undone operation. + \header \li Keypress \li Action + \row \li Left Arrow \li Moves the cursor one character to the left. + \row \li Shift+Left Arrow \li Moves and selects text one character to the left. + \row \li Right Arrow \li Moves the cursor one character to the right. + \row \li Shift+Right Arrow \li Moves and selects text one character to the right. + \row \li Home \li Moves the cursor to the beginning of the line. + \row \li End \li Moves the cursor to the end of the line. + \row \li Backspace \li Deletes the character to the left of the cursor. + \row \li Ctrl+Backspace \li Deletes the word to the left of the cursor. + \row \li Delete \li Deletes the character to the right of the cursor. + \row \li Ctrl+Delete \li Deletes the word to the right of the cursor. + \row \li Ctrl+A \li Select all. + \row \li Ctrl+C \li Copies the selected text to the clipboard. + \row \li Ctrl+Insert \li Copies the selected text to the clipboard. + \row \li Ctrl+K \li Deletes to the end of the line. + \row \li Ctrl+V \li Pastes the clipboard text into line edit. + \row \li Shift+Insert \li Pastes the clipboard text into line edit. + \row \li Ctrl+X \li Deletes the selected text and copies it to the clipboard. + \row \li Shift+Delete \li Deletes the selected text and copies it to the clipboard. + \row \li Ctrl+Z \li Undoes the last operation. + \row \li Ctrl+Y \li Redoes the last undone operation. \endtable Any other key sequence that represents a valid character, will cause the character to be inserted into the line edit. \table 100% - \row \o \inlineimage macintosh-lineedit.png Screenshot of a Macintosh style line edit - \o A line edit shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage windows-lineedit.png Screenshot of a Windows XP style line edit - \o A line edit shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage plastique-lineedit.png Screenshot of a Plastique style line edit - \o A line edit shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage macintosh-lineedit.png Screenshot of a Macintosh style line edit + \li A line edit shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage windows-lineedit.png Screenshot of a Windows XP style line edit + \li A line edit shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage plastique-lineedit.png Screenshot of a Plastique style line edit + \li A line edit shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QTextEdit, QLabel, QComboBox, {fowler}{GUI Design Handbook: Field, Entry}, {Line Edits Example} @@ -1096,26 +1096,26 @@ QMargins QLineEdit::textMargins() const where a character is \e{permitted but not required}. \table - \header \i Character \i Meaning - \row \i \c A \i ASCII alphabetic character required. A-Z, a-z. - \row \i \c a \i ASCII alphabetic character permitted but not required. - \row \i \c N \i ASCII alphanumeric character required. A-Z, a-z, 0-9. - \row \i \c n \i ASCII alphanumeric character permitted but not required. - \row \i \c X \i Any character required. - \row \i \c x \i Any character permitted but not required. - \row \i \c 9 \i ASCII digit required. 0-9. - \row \i \c 0 \i ASCII digit permitted but not required. - \row \i \c D \i ASCII digit required. 1-9. - \row \i \c d \i ASCII digit permitted but not required (1-9). - \row \i \c # \i ASCII digit or plus/minus sign permitted but not required. - \row \i \c H \i Hexadecimal character required. A-F, a-f, 0-9. - \row \i \c h \i Hexadecimal character permitted but not required. - \row \i \c B \i Binary character required. 0-1. - \row \i \c b \i Binary character permitted but not required. - \row \i \c > \i All following alphabetic characters are uppercased. - \row \i \c < \i All following alphabetic characters are lowercased. - \row \i \c ! \i Switch off case conversion. - \row \i \tt{\\} \i Use \tt{\\} to escape the special + \header \li Character \li Meaning + \row \li \c A \li ASCII alphabetic character required. A-Z, a-z. + \row \li \c a \li ASCII alphabetic character permitted but not required. + \row \li \c N \li ASCII alphanumeric character required. A-Z, a-z, 0-9. + \row \li \c n \li ASCII alphanumeric character permitted but not required. + \row \li \c X \li Any character required. + \row \li \c x \li Any character permitted but not required. + \row \li \c 9 \li ASCII digit required. 0-9. + \row \li \c 0 \li ASCII digit permitted but not required. + \row \li \c D \li ASCII digit required. 1-9. + \row \li \c d \li ASCII digit permitted but not required (1-9). + \row \li \c # \li ASCII digit or plus/minus sign permitted but not required. + \row \li \c H \li Hexadecimal character required. A-F, a-f, 0-9. + \row \li \c h \li Hexadecimal character permitted but not required. + \row \li \c B \li Binary character required. 0-1. + \row \li \c b \li Binary character permitted but not required. + \row \li \c > \li All following alphabetic characters are uppercased. + \row \li \c < \li All following alphabetic characters are lowercased. + \row \li \c ! \li Switch off case conversion. + \row \li \tt{\\} \li Use \tt{\\} to escape the special characters listed above to use them as separators. \endtable @@ -1127,11 +1127,11 @@ QMargins QLineEdit::textMargins() const Examples: \table - \header \i Mask \i Notes - \row \i \c 000.000.000.000;_ \i IP address; blanks are \c{_}. - \row \i \c HH:HH:HH:HH:HH:HH;_ \i MAC address - \row \i \c 0000-00-00 \i ISO Date; blanks are \c space - \row \i \c >AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;# \i License number; + \header \li Mask \li Notes + \row \li \c 000.000.000.000;_ \li IP address; blanks are \c{_}. + \row \li \c HH:HH:HH:HH:HH:HH;_ \li MAC address + \row \li \c 0000-00-00 \li ISO Date; blanks are \c space + \row \li \c >AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;# \li License number; blanks are \c - and all (alphabetic) characters are converted to uppercase. \endtable diff --git a/src/widgets/widgets/qmainwindow.cpp b/src/widgets/widgets/qmainwindow.cpp index 73ba0cc15e..7607f2f238 100644 --- a/src/widgets/widgets/qmainwindow.cpp +++ b/src/widgets/widgets/qmainwindow.cpp @@ -1480,12 +1480,12 @@ bool QMainWindow::event(QEvent *event) moved to that. This means a couple of things. \list - \i QToolBars in this toolbar area are not movable and you cannot drag other + \li QToolBars in this toolbar area are not movable and you cannot drag other toolbars to it - \i Toolbar breaks are not respected or preserved - \i Any custom widgets in the toolbar will not be shown if the toolbar + \li Toolbar breaks are not respected or preserved + \li Any custom widgets in the toolbar will not be shown if the toolbar becomes too small (only actions will be shown) - \i Before Qt 4.5, if you called showFullScreen() on the main window, the QToolbar would + \li Before Qt 4.5, if you called showFullScreen() on the main window, the QToolbar would disappear since it is considered to be part of the title bar. Qt 4.5 and up will now work around this by pulling the toolbars out and back into the regular toolbar and vice versa when you swap out. \endlist diff --git a/src/widgets/widgets/qmdiarea.cpp b/src/widgets/widgets/qmdiarea.cpp index 7d73a66c5c..36fba72963 100644 --- a/src/widgets/widgets/qmdiarea.cpp +++ b/src/widgets/widgets/qmdiarea.cpp @@ -92,8 +92,8 @@ slots and are easily connected to menu entries. \table - \row \o \inlineimage mdi-cascade.png - \o \inlineimage mdi-tile.png + \row \li \inlineimage mdi-cascade.png + \li \inlineimage mdi-tile.png \endtable \note The default scroll bar property for QMdiArea is Qt::ScrollBarAlwaysOff. diff --git a/src/widgets/widgets/qmenu.cpp b/src/widgets/widgets/qmenu.cpp index 7ebfdbecae..3fb2a6122c 100644 --- a/src/widgets/widgets/qmenu.cpp +++ b/src/widgets/widgets/qmenu.cpp @@ -1218,9 +1218,9 @@ void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) \table 100% \row - \o \inlineimage plastique-menu.png - \o \inlineimage windowsxp-menu.png - \o \inlineimage macintosh-menu.png + \li \inlineimage plastique-menu.png + \li \inlineimage windowsxp-menu.png + \li \inlineimage macintosh-menu.png \endtable \caption Fig. A menu shown in \l{Plastique Style Widget Gallery}{Plastique widget style}, \l{Windows XP Style Widget Gallery}{Windows XP widget style}, @@ -1284,7 +1284,7 @@ void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) See the \l{mainwindows/menus}{Menus} example for an example of how to use QMenuBar and QMenu in your application. - \bold{Important inherited functions:} addAction(), removeAction(), clear(), + \b{Important inherited functions:} addAction(), removeAction(), clear(), addSeparator(), and addMenu(). \sa QMenuBar, {fowler}{GUI Design Handbook: Menu, Drop-Down and Pop-Up}, diff --git a/src/widgets/widgets/qmenubar.cpp b/src/widgets/widgets/qmenubar.cpp index 16e486e77f..11f6592cc9 100644 --- a/src/widgets/widgets/qmenubar.cpp +++ b/src/widgets/widgets/qmenubar.cpp @@ -621,17 +621,17 @@ void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *acti \table - \row \o \inlineimage plastique-menubar.png A menu bar shown in the + \row \li \inlineimage plastique-menubar.png A menu bar shown in the Plastique widget style. - \o The \l{QPlastiqueStyle}{Plastique widget style}, like most + \li The \l{QPlastiqueStyle}{Plastique widget style}, like most other styles, handles the \gui{Help} menu in the same way as it handles any other menu. - \row \o \inlineimage motif-menubar.png A menu bar shown in the + \row \li \inlineimage motif-menubar.png A menu bar shown in the Motif widget style. - \o The \l{QMotifStyle}{Motif widget style} treats \gui{Help} menus + \li The \l{QMotifStyle}{Motif widget style} treats \gui{Help} menus in a special way, placing them at right-hand end of the menu bar. \endtable @@ -652,18 +652,18 @@ void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *acti the strings looked for and where the entry is placed if matched: \table - \header \i String matches \i Placement \i Notes - \row \i about.* - \i Application Menu | About <application name> - \i The application name is fetched from the \c {Info.plist} file + \header \li String matches \li Placement \li Notes + \row \li about.* + \li Application Menu | About <application name> + \li The application name is fetched from the \c {Info.plist} file (see note below). If this entry is not found no About item will appear in the Application Menu. - \row \i config, options, setup, settings or preferences - \i Application Menu | Preferences - \i If this entry is not found the Settings item will be disabled - \row \i quit or exit - \i Application Menu | Quit <application name> - \i If this entry is not found a default Quit item will be + \row \li config, options, setup, settings or preferences + \li Application Menu | Preferences + \li If this entry is not found the Settings item will be disabled + \row \li quit or exit + \li Application Menu | Quit <application name> + \li If this entry is not found a default Quit item will be created to call QApplication::quit() \endtable @@ -676,12 +676,12 @@ void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *acti \snippet doc/src/snippets/code/src_gui_widgets_qmenubar.cpp 1 - \bold{Note:} Do \e{not} call QMainWindow::menuBar() to create the + \b{Note:} Do \e{not} call QMainWindow::menuBar() to create the shared menu bar, because that menu bar will have the QMainWindow as its parent. That menu bar would only be displayed for the parent QMainWindow. - \bold{Note:} The text used for the application name in the menu + \b{Note:} The text used for the application name in the menu bar is obtained from the value set in the \c{Info.plist} file in the application's bundle. See \l{Deploying an Application on Mac OS X} for more information. diff --git a/src/widgets/widgets/qplaintextedit.cpp b/src/widgets/widgets/qplaintextedit.cpp index de6cb6a283..fad2d4e747 100644 --- a/src/widgets/widgets/qplaintextedit.cpp +++ b/src/widgets/widgets/qplaintextedit.cpp @@ -1081,19 +1081,19 @@ void QPlainTextEditPrivate::ensureViewportLayouted() When QPlainTextEdit is used read-only the key bindings are limited to navigation, and text may only be selected with the mouse: \table - \header \i Keypresses \i Action - \row \i Qt::UpArrow \i Moves one line up. - \row \i Qt::DownArrow \i Moves one line down. - \row \i Qt::LeftArrow \i Moves one character to the left. - \row \i Qt::RightArrow \i Moves one character to the right. - \row \i PageUp \i Moves one (viewport) page up. - \row \i PageDown \i Moves one (viewport) page down. - \row \i Home \i Moves to the beginning of the text. - \row \i End \i Moves to the end of the text. - \row \i Alt+Wheel - \i Scrolls the page horizontally (the Wheel is the mouse wheel). - \row \i Ctrl+Wheel \i Zooms the text. - \row \i Ctrl+A \i Selects all text. + \header \li Keypresses \li Action + \row \li Qt::UpArrow \li Moves one line up. + \row \li Qt::DownArrow \li Moves one line down. + \row \li Qt::LeftArrow \li Moves one character to the left. + \row \li Qt::RightArrow \li Moves one character to the right. + \row \li PageUp \li Moves one (viewport) page up. + \row \li PageDown \li Moves one (viewport) page down. + \row \li Home \li Moves to the beginning of the text. + \row \li End \li Moves to the end of the text. + \row \li Alt+Wheel + \li Scrolls the page horizontally (the Wheel is the mouse wheel). + \row \li Ctrl+Wheel \li Zooms the text. + \row \li Ctrl+A \li Selects all text. \endtable @@ -1127,34 +1127,34 @@ void QPlainTextEditPrivate::ensureViewportLayouted() The list of key bindings which are implemented for editing: \table - \header \i Keypresses \i Action - \row \i Backspace \i Deletes the character to the left of the cursor. - \row \i Delete \i Deletes the character to the right of the cursor. - \row \i Ctrl+C \i Copy the selected text to the clipboard. - \row \i Ctrl+Insert \i Copy the selected text to the clipboard. - \row \i Ctrl+K \i Deletes to the end of the line. - \row \i Ctrl+V \i Pastes the clipboard text into text edit. - \row \i Shift+Insert \i Pastes the clipboard text into text edit. - \row \i Ctrl+X \i Deletes the selected text and copies it to the clipboard. - \row \i Shift+Delete \i Deletes the selected text and copies it to the clipboard. - \row \i Ctrl+Z \i Undoes the last operation. - \row \i Ctrl+Y \i Redoes the last operation. - \row \i LeftArrow \i Moves the cursor one character to the left. - \row \i Ctrl+LeftArrow \i Moves the cursor one word to the left. - \row \i RightArrow \i Moves the cursor one character to the right. - \row \i Ctrl+RightArrow \i Moves the cursor one word to the right. - \row \i UpArrow \i Moves the cursor one line up. - \row \i Ctrl+UpArrow \i Moves the cursor one word up. - \row \i DownArrow \i Moves the cursor one line down. - \row \i Ctrl+Down Arrow \i Moves the cursor one word down. - \row \i PageUp \i Moves the cursor one page up. - \row \i PageDown \i Moves the cursor one page down. - \row \i Home \i Moves the cursor to the beginning of the line. - \row \i Ctrl+Home \i Moves the cursor to the beginning of the text. - \row \i End \i Moves the cursor to the end of the line. - \row \i Ctrl+End \i Moves the cursor to the end of the text. - \row \i Alt+Wheel \i Scrolls the page horizontally (the Wheel is the mouse wheel). - \row \i Ctrl+Wheel \i Zooms the text. + \header \li Keypresses \li Action + \row \li Backspace \li Deletes the character to the left of the cursor. + \row \li Delete \li Deletes the character to the right of the cursor. + \row \li Ctrl+C \li Copy the selected text to the clipboard. + \row \li Ctrl+Insert \li Copy the selected text to the clipboard. + \row \li Ctrl+K \li Deletes to the end of the line. + \row \li Ctrl+V \li Pastes the clipboard text into text edit. + \row \li Shift+Insert \li Pastes the clipboard text into text edit. + \row \li Ctrl+X \li Deletes the selected text and copies it to the clipboard. + \row \li Shift+Delete \li Deletes the selected text and copies it to the clipboard. + \row \li Ctrl+Z \li Undoes the last operation. + \row \li Ctrl+Y \li Redoes the last operation. + \row \li LeftArrow \li Moves the cursor one character to the left. + \row \li Ctrl+LeftArrow \li Moves the cursor one word to the left. + \row \li RightArrow \li Moves the cursor one character to the right. + \row \li Ctrl+RightArrow \li Moves the cursor one word to the right. + \row \li UpArrow \li Moves the cursor one line up. + \row \li Ctrl+UpArrow \li Moves the cursor one word up. + \row \li DownArrow \li Moves the cursor one line down. + \row \li Ctrl+Down Arrow \li Moves the cursor one word down. + \row \li PageUp \li Moves the cursor one page up. + \row \li PageDown \li Moves the cursor one page down. + \row \li Home \li Moves the cursor to the beginning of the line. + \row \li Ctrl+Home \li Moves the cursor to the beginning of the text. + \row \li End \li Moves the cursor to the end of the line. + \row \li Ctrl+End \li Moves the cursor to the end of the text. + \row \li Alt+Wheel \li Scrolls the page horizontally (the Wheel is the mouse wheel). + \row \li Ctrl+Wheel \li Zooms the text. \endtable To select (mark) text hold down the Shift key whilst pressing one diff --git a/src/widgets/widgets/qprogressbar.cpp b/src/widgets/widgets/qprogressbar.cpp index eabed2ee62..816b847cf5 100644 --- a/src/widgets/widgets/qprogressbar.cpp +++ b/src/widgets/widgets/qprogressbar.cpp @@ -196,12 +196,12 @@ bool QProgressBarPrivate::repaintRequired() const they are unable to determine the size of the item being downloaded. \table - \row \o \inlineimage macintosh-progressbar.png Screenshot of a Macintosh style progress bar - \o A progress bar shown in the Macintosh widget style. - \row \o \inlineimage windowsxp-progressbar.png Screenshot of a Windows XP style progress bar - \o A progress bar shown in the Windows XP widget style. - \row \o \inlineimage plastique-progressbar.png Screenshot of a Plastique style progress bar - \o A progress bar shown in the Plastique widget style. + \row \li \inlineimage macintosh-progressbar.png Screenshot of a Macintosh style progress bar + \li A progress bar shown in the Macintosh widget style. + \row \li \inlineimage windowsxp-progressbar.png Screenshot of a Windows XP style progress bar + \li A progress bar shown in the Windows XP widget style. + \row \li \inlineimage plastique-progressbar.png Screenshot of a Plastique style progress bar + \li A progress bar shown in the Plastique widget style. \endtable \sa QProgressDialog, {fowler}{GUI Design Handbook: Progress Indicator} diff --git a/src/widgets/widgets/qpushbutton.cpp b/src/widgets/widgets/qpushbutton.cpp index 99252c43dc..7ca5dcb486 100644 --- a/src/widgets/widgets/qpushbutton.cpp +++ b/src/widgets/widgets/qpushbutton.cpp @@ -126,13 +126,13 @@ QT_BEGIN_NAMESPACE The most important modes or states are: \list - \i Available or not (grayed out, disabled). - \i Standard push button, toggling push button or menu button. - \i On or off (only for toggling push buttons). - \i Default or normal. The default button in a dialog can generally + \li Available or not (grayed out, disabled). + \li Standard push button, toggling push button or menu button. + \li On or off (only for toggling push buttons). + \li Default or normal. The default button in a dialog can generally be "clicked" using the Enter or Return key. - \i Auto-repeat or not. - \i Pressed down or not. + \li Auto-repeat or not. + \li Pressed down or not. \endlist As a general rule, use a push button when the application or @@ -160,18 +160,18 @@ QT_BEGIN_NAMESPACE check boxes (see QCheckBox). \table 100% - \row \o \inlineimage macintosh-pushbutton.png Screenshot of a Macintosh style push button - \o A push button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage macintosh-pushbutton.png Screenshot of a Macintosh style push button + \li A push button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. Note that when a button's width becomes smaller than 50 or its height becomes smaller than 30, the button's corners are changed from round to square. Use the setMinimumSize() function to prevent this behavior. - \row \o \inlineimage windowsxp-pushbutton.png Screenshot of a Windows XP style push button - \o A push button shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage plastique-pushbutton.png Screenshot of a Plastique style push button - \o A push button shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage windowsxp-pushbutton.png Screenshot of a Windows XP style push button + \li A push button shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage plastique-pushbutton.png Screenshot of a Plastique style push button + \li A push button shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable In Qt, the QAbstractButton base class provides most of the modes @@ -518,9 +518,9 @@ void QPushButton::focusOutEvent(QFocusEvent *e) \table 100% \row - \o \inlineimage plastique-pushbutton-menu.png Screenshot of a Plastique style push button with popup menu. - \o \inlineimage cleanlooks-pushbutton-menu.png Screenshot of a Cleanlooks style push button with popup menu. - \o Push buttons with popup menus shown in the \l{Plastique Style Widget Gallery}{Plastique widget style} + \li \inlineimage plastique-pushbutton-menu.png Screenshot of a Plastique style push button with popup menu. + \li \inlineimage cleanlooks-pushbutton-menu.png Screenshot of a Cleanlooks style push button with popup menu. + \li Push buttons with popup menus shown in the \l{Plastique Style Widget Gallery}{Plastique widget style} (left) and \l{Cleanlooks Style Widget Gallery}{Cleanlooks widget style} (right). \endtable diff --git a/src/widgets/widgets/qradiobutton.cpp b/src/widgets/widgets/qradiobutton.cpp index 792550949b..11cd89bca2 100644 --- a/src/widgets/widgets/qradiobutton.cpp +++ b/src/widgets/widgets/qradiobutton.cpp @@ -116,12 +116,12 @@ void QRadioButtonPrivate::init() toggle(), pressed(), released(), clicked(), and toggled(). \table 100% - \row \o \inlineimage plastique-radiobutton.png Screenshot of a Plastique radio button - \o A radio button shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. - \row \o \inlineimage windows-radiobutton.png Screenshot of a Windows XP radio button - \o A radio button shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage macintosh-radiobutton.png Screenshot of a Macintosh radio button - \o A radio button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage plastique-radiobutton.png Screenshot of a Plastique radio button + \li A radio button shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage windows-radiobutton.png Screenshot of a Windows XP radio button + \li A radio button shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage macintosh-radiobutton.png Screenshot of a Macintosh radio button + \li A radio button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. \endtable \sa QPushButton, QToolButton, QCheckBox, {fowler}{GUI Design Handbook: Radio Button}, diff --git a/src/widgets/widgets/qscrollarea.cpp b/src/widgets/widgets/qscrollarea.cpp index 490dea0d2d..84be2d569b 100644 --- a/src/widgets/widgets/qscrollarea.cpp +++ b/src/widgets/widgets/qscrollarea.cpp @@ -77,9 +77,9 @@ QT_BEGIN_NAMESPACE \table \row - \o \inlineimage qscrollarea-noscrollbars.png - \o \inlineimage qscrollarea-onescrollbar.png - \o \inlineimage qscrollarea-twoscrollbars.png + \li \inlineimage qscrollarea-noscrollbars.png + \li \inlineimage qscrollarea-onescrollbar.png + \li \inlineimage qscrollarea-twoscrollbars.png \endtable The scroll bars appearance depends on the currently set \l diff --git a/src/widgets/widgets/qscrollbar.cpp b/src/widgets/widgets/qscrollbar.cpp index cb3126e566..6ac5473f2e 100644 --- a/src/widgets/widgets/qscrollbar.cpp +++ b/src/widgets/widgets/qscrollbar.cpp @@ -83,21 +83,21 @@ QT_BEGIN_NAMESPACE needs. \table - \row \o \image qscrollbar-picture.png - \o Scroll bars typically include four separate controls: a slider, + \row \li \image qscrollbar-picture.png + \li Scroll bars typically include four separate controls: a slider, scroll arrows, and a page control. \list - \o a. The slider provides a way to quickly go to any part of the + \li a. The slider provides a way to quickly go to any part of the document, but does not support accurate navigation within large documents. - \o b. The scroll arrows are push buttons which can be used to accurately + \li b. The scroll arrows are push buttons which can be used to accurately navigate to a particular place in a document. For a vertical scroll bar connected to a text editor, these typically move the current position one "line" up or down, and adjust the position of the slider by a small amount. In editors and list boxes a "line" might mean one line of text; in an image viewer it might mean 20 pixels. - \o c. The page control is the area over which the slider is dragged (the + \li c. The page control is the area over which the slider is dragged (the scroll bar's background). Clicking here moves the scroll bar towards the click by one "page". This value is usually the same as the length of the slider. @@ -135,8 +135,8 @@ QT_BEGIN_NAMESPACE value of 80. This would give us a scroll bar with five "pages". \table - \row \o \inlineimage qscrollbar-values.png - \o The relationship between a document length, the range of values used + \row \li \inlineimage qscrollbar-values.png + \li The relationship between a document length, the range of values used in a scroll bar, and the page step is simple in many common situations. The scroll bar's range of values is determined by subtracting a chosen page step from some value representing the length of the document. @@ -153,18 +153,18 @@ QT_BEGIN_NAMESPACE ScrollBar inherits a comprehensive set of signals from QAbstractSlider: \list - \o \l{QAbstractSlider::valueChanged()}{valueChanged()} is emitted when the + \li \l{QAbstractSlider::valueChanged()}{valueChanged()} is emitted when the scroll bar's value has changed. The tracking() determines whether this signal is emitted during user interaction. - \o \l{QAbstractSlider::rangeChanged()}{rangeChanged()} is emitted when the + \li \l{QAbstractSlider::rangeChanged()}{rangeChanged()} is emitted when the scroll bar's range of values has changed. - \o \l{QAbstractSlider::sliderPressed()}{sliderPressed()} is emitted when + \li \l{QAbstractSlider::sliderPressed()}{sliderPressed()} is emitted when the user starts to drag the slider. - \o \l{QAbstractSlider::sliderMoved()}{sliderMoved()} is emitted when the user + \li \l{QAbstractSlider::sliderMoved()}{sliderMoved()} is emitted when the user drags the slider. - \o \l{QAbstractSlider::sliderReleased()}{sliderReleased()} is emitted when + \li \l{QAbstractSlider::sliderReleased()}{sliderReleased()} is emitted when the user releases the slider. - \o \l{QAbstractSlider::actionTriggered()}{actionTriggered()} is emitted + \li \l{QAbstractSlider::actionTriggered()}{actionTriggered()} is emitted when the scroll bar is changed by user interaction or via the \l{QAbstractSlider::triggerAction()}{triggerAction()} function. \endlist @@ -173,12 +173,12 @@ QT_BEGIN_NAMESPACE default focusPolicy() of Qt::NoFocus. Use setFocusPolicy() to enable keyboard interaction with the scroll bar: \list - \o Left/Right move a horizontal scroll bar by one single step. - \o Up/Down move a vertical scroll bar by one single step. - \o PageUp moves up one page. - \o PageDown moves down one page. - \o Home moves to the start (mininum). - \o End moves to the end (maximum). + \li Left/Right move a horizontal scroll bar by one single step. + \li Up/Down move a vertical scroll bar by one single step. + \li PageUp moves up one page. + \li PageDown moves down one page. + \li Home moves to the start (mininum). + \li End moves to the end (maximum). \endlist The slider itself can be controlled by using the @@ -190,12 +190,12 @@ QT_BEGIN_NAMESPACE slider. \table 100% - \row \o \inlineimage macintosh-horizontalscrollbar.png Screenshot of a Macintosh style scroll bar - \o A scroll bar shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage windowsxp-horizontalscrollbar.png Screenshot of a Windows XP style scroll bar - \o A scroll bar shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage plastique-horizontalscrollbar.png Screenshot of a Plastique style scroll bar - \o A scroll bar shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage macintosh-horizontalscrollbar.png Screenshot of a Macintosh style scroll bar + \li A scroll bar shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage windowsxp-horizontalscrollbar.png Screenshot of a Windows XP style scroll bar + \li A scroll bar shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage plastique-horizontalscrollbar.png Screenshot of a Plastique style scroll bar + \li A scroll bar shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QScrollArea, QSlider, QDial, QSpinBox, {fowler}{GUI Design Handbook: Scroll Bar}, {Sliders Example} diff --git a/src/widgets/widgets/qsizegrip.cpp b/src/widgets/widgets/qsizegrip.cpp index 09557a3c90..4a5269c110 100644 --- a/src/widgets/widgets/qsizegrip.cpp +++ b/src/widgets/widgets/qsizegrip.cpp @@ -195,8 +195,8 @@ Qt::Corner QSizeGripPrivate::corner() const window is shown full screen or maximised. \table 50% - \row \o \inlineimage plastique-sizegrip.png Screenshot of a Plastique style size grip - \o A size grip widget at the bottom-right corner of a main window, shown in the + \row \li \inlineimage plastique-sizegrip.png Screenshot of a Plastique style size grip + \li A size grip widget at the bottom-right corner of a main window, shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable diff --git a/src/widgets/widgets/qslider.cpp b/src/widgets/widgets/qslider.cpp index b05726c965..7f77bc9d03 100644 --- a/src/widgets/widgets/qslider.cpp +++ b/src/widgets/widgets/qslider.cpp @@ -225,17 +225,17 @@ QStyle::SubControl QSliderPrivate::newHoverControl(const QPoint &pos) QSlider inherits a comprehensive set of signals: \table - \header \o Signal \o Description - \row \o \l valueChanged() - \o Emitted when the slider's value has changed. The tracking() + \header \li Signal \li Description + \row \li \l valueChanged() + \li Emitted when the slider's value has changed. The tracking() determines whether this signal is emitted during user interaction. - \row \o \l sliderPressed() - \o Emitted when the user starts to drag the slider. - \row \o \l sliderMoved() - \o Emitted when the user drags the slider. - \row \o \l sliderReleased() - \o Emitted when the user releases the slider. + \row \li \l sliderPressed() + \li Emitted when the user starts to drag the slider. + \row \li \l sliderMoved() + \li Emitted when the user drags the slider. + \row \li \l sliderReleased() + \li Emitted when the user releases the slider. \endtable QSlider only provides integer ranges. Note that although @@ -246,21 +246,21 @@ QStyle::SubControl QSliderPrivate::newHoverControl(const QPoint &pos) keyboard interface. The keyboard interface is the following: \list - \o Left/Right move a horizontal slider by one single step. - \o Up/Down move a vertical slider by one single step. - \o PageUp moves up one page. - \o PageDown moves down one page. - \o Home moves to the start (mininum). - \o End moves to the end (maximum). + \li Left/Right move a horizontal slider by one single step. + \li Up/Down move a vertical slider by one single step. + \li PageUp moves up one page. + \li PageDown moves down one page. + \li Home moves to the start (mininum). + \li End moves to the end (maximum). \endlist \table 100% - \row \o \inlineimage macintosh-slider.png Screenshot of a Macintosh slider - \o A slider shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. - \row \o \inlineimage windows-slider.png Screenshot of a Windows XP slider - \o A slider shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage plastique-slider.png Screenshot of a Plastique slider - \o A slider shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage macintosh-slider.png Screenshot of a Macintosh slider + \li A slider shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage windows-slider.png Screenshot of a Windows XP slider + \li A slider shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage plastique-slider.png Screenshot of a Plastique slider + \li A slider shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. \endtable \sa QScrollBar, QSpinBox, QDial, {fowler}{GUI Design Handbook: Slider}, {Sliders Example} diff --git a/src/widgets/widgets/qspinbox.cpp b/src/widgets/widgets/qspinbox.cpp index 3038d8e30c..7dcaead2f4 100644 --- a/src/widgets/widgets/qspinbox.cpp +++ b/src/widgets/widgets/qspinbox.cpp @@ -152,12 +152,12 @@ public: setSpecialValueText() for how to do this with QSpinBox. \table 100% - \row \o \inlineimage windowsxp-spinbox.png Screenshot of a Windows XP spin box - \o A spin box shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. - \row \o \inlineimage plastique-spinbox.png Screenshot of a Plastique spin box - \o A spin box shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. - \row \o \inlineimage macintosh-spinbox.png Screenshot of a Macintosh spin box - \o A spin box shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. + \row \li \inlineimage windowsxp-spinbox.png Screenshot of a Windows XP spin box + \li A spin box shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}. + \row \li \inlineimage plastique-spinbox.png Screenshot of a Plastique spin box + \li A spin box shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}. + \row \li \inlineimage macintosh-spinbox.png Screenshot of a Macintosh spin box + \li A spin box shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}. \endtable \section1 Subclassing QSpinBox diff --git a/src/widgets/widgets/qstackedwidget.cpp b/src/widgets/widgets/qstackedwidget.cpp index 5a8a382a58..9617d6de58 100644 --- a/src/widgets/widgets/qstackedwidget.cpp +++ b/src/widgets/widgets/qstackedwidget.cpp @@ -232,7 +232,7 @@ int QStackedWidget::insertWidget(int index, QWidget *widget) not deleted but simply removed from the stacked layout, causing it to be hidden. - \bold{Note:} Ownership of \a widget reverts to the application. + \b{Note:} Ownership of \a widget reverts to the application. \sa addWidget(), insertWidget(), currentWidget() */ diff --git a/src/widgets/widgets/qstatusbar.cpp b/src/widgets/widgets/qstatusbar.cpp index 9f170626da..4b9242499c 100644 --- a/src/widgets/widgets/qstatusbar.cpp +++ b/src/widgets/widgets/qstatusbar.cpp @@ -165,12 +165,12 @@ QRect QStatusBarPrivate::messageRect() const Each status indicator falls into one of three categories: \list - \o \e Temporary - briefly occupies most of the status bar. Used + \li \e Temporary - briefly occupies most of the status bar. Used to explain tool tip texts or menu entries, for example. - \o \e Normal - occupies part of the status bar and may be hidden + \li \e Normal - occupies part of the status bar and may be hidden by temporary messages. Used to display the page and line number in a word processor, for example. - \o \e Permanent - is never hidden. Used for important mode + \li \e Permanent - is never hidden. Used for important mode indications, for example, some applications put a Caps Lock indicator in the status bar. \endlist diff --git a/src/widgets/widgets/qtabbar.cpp b/src/widgets/widgets/qtabbar.cpp index 580aea10b9..ca94854d11 100644 --- a/src/widgets/widgets/qtabbar.cpp +++ b/src/widgets/widgets/qtabbar.cpp @@ -252,21 +252,21 @@ void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const tab: \list - \i tabSizeHint() calcuates the size of a tab. - \i tabInserted() notifies that a new tab was added. - \i tabRemoved() notifies that a tab was removed. - \i tabLayoutChange() notifies that the tabs have been re-laid out. - \i paintEvent() paints all tabs. + \li tabSizeHint() calcuates the size of a tab. + \li tabInserted() notifies that a new tab was added. + \li tabRemoved() notifies that a tab was removed. + \li tabLayoutChange() notifies that the tabs have been re-laid out. + \li paintEvent() paints all tabs. \endlist For subclasses, you might also need the tabRect() functions which returns the visual geometry of a single tab. \table 100% - \row \o \inlineimage plastique-tabbar.png Screenshot of a Plastique style tab bar - \o A tab bar shown in the Plastique widget style. - \row \o \inlineimage plastique-tabbar-truncated.png Screenshot of a truncated Plastique tab bar - \o A truncated tab bar shown in the Plastique widget style. + \row \li \inlineimage plastique-tabbar.png Screenshot of a Plastique style tab bar + \li A tab bar shown in the Plastique widget style. + \row \li \inlineimage plastique-tabbar-truncated.png Screenshot of a truncated Plastique tab bar + \li A truncated tab bar shown in the Plastique widget style. \endtable \sa QTabWidget diff --git a/src/widgets/widgets/qtabwidget.cpp b/src/widgets/widgets/qtabwidget.cpp index 612d51826c..505287512e 100644 --- a/src/widgets/widgets/qtabwidget.cpp +++ b/src/widgets/widgets/qtabwidget.cpp @@ -77,12 +77,12 @@ QT_BEGIN_NAMESPACE The normal way to use QTabWidget is to do the following: \list 1 - \i Create a QTabWidget. - \i Create a QWidget for each of the pages in the tab dialog, but + \li Create a QTabWidget. + \li Create a QWidget for each of the pages in the tab dialog, but do not specify parent widgets for them. - \i Insert child widgets into the page widget, using layouts to + \li Insert child widgets into the page widget, using layouts to position them as normal. - \i Call addTab() or insertTab() to put the page widgets into the + \li Call addTab() or insertTab() to put the page widgets into the tab widget, giving each tab a suitable label with an optional keyboard shortcut. \endlist @@ -120,12 +120,12 @@ QT_BEGIN_NAMESPACE area, organizing the individual pages). \table 100% - \row \o \inlineimage windowsxp-tabwidget.png Screenshot of a Windows XP style tab widget - \o \inlineimage macintosh-tabwidget.png Screenshot of a Macintosh style tab widget - \o \inlineimage plastique-tabwidget.png Screenshot of a Plastique style tab widget - \row \o A Windows XP style tab widget. - \o A Macintosh style tab widget. - \o A Plastique style tab widget. + \row \li \inlineimage windowsxp-tabwidget.png Screenshot of a Windows XP style tab widget + \li \inlineimage macintosh-tabwidget.png Screenshot of a Macintosh style tab widget + \li \inlineimage plastique-tabwidget.png Screenshot of a Plastique style tab widget + \row \li A Windows XP style tab widget. + \li A Macintosh style tab widget. + \li A Plastique style tab widget. \endtable \sa QTabBar, QStackedWidget, QToolBox, {Tab Dialog Example} diff --git a/src/widgets/widgets/qtextbrowser.cpp b/src/widgets/widgets/qtextbrowser.cpp index d9229c12e8..050730ec2a 100644 --- a/src/widgets/widgets/qtextbrowser.cpp +++ b/src/widgets/widgets/qtextbrowser.cpp @@ -902,10 +902,10 @@ void QTextBrowser::home() /*! The event \a ev is used to provide the following keyboard shortcuts: \table - \header \i Keypress \i Action - \row \i Alt+Left Arrow \i \l backward() - \row \i Alt+Right Arrow \i \l forward() - \row \i Alt+Up Arrow \i \l home() + \header \li Keypress \li Action + \row \li Alt+Left Arrow \li \l backward() + \row \li Alt+Right Arrow \li \l forward() + \row \li Alt+Up Arrow \li \l home() \endtable */ void QTextBrowser::keyPressEvent(QKeyEvent *ev) @@ -1068,10 +1068,10 @@ void QTextBrowser::paintEvent(QPaintEvent *e) depending on the resource type: \table - \header \i ResourceType \i QVariant::Type - \row \i QTextDocument::HtmlResource \i QString or QByteArray - \row \i QTextDocument::ImageResource \i QImage, QPixmap or QByteArray - \row \i QTextDocument::StyleSheetResource \i QString or QByteArray + \header \li ResourceType \li QVariant::Type + \row \li QTextDocument::HtmlResource \li QString or QByteArray + \row \li QTextDocument::ImageResource \li QImage, QPixmap or QByteArray + \row \li QTextDocument::StyleSheetResource \li QString or QByteArray \endtable */ QVariant QTextBrowser::loadResource(int /*type*/, const QUrl &name) @@ -1146,10 +1146,10 @@ void QTextBrowser::clearHistory() Returns the url of the HistoryItem. \table - \header \i Input \i Return - \row \i \a{i} < 0 \i \l backward() history - \row \i\a{i} == 0 \i current, see QTextBrowser::source() - \row \i \a{i} > 0 \i \l forward() history + \header \li Input \li Return + \row \li \a{i} < 0 \li \l backward() history + \row \li\a{i} == 0 \li current, see QTextBrowser::source() + \row \li \a{i} > 0 \li \l forward() history \endtable \since 4.4 @@ -1164,10 +1164,10 @@ QUrl QTextBrowser::historyUrl(int i) const Returns the documentTitle() of the HistoryItem. \table - \header \i Input \i Return - \row \i \a{i} < 0 \i \l backward() history - \row \i \a{i} == 0 \i current, see QTextBrowser::source() - \row \i \a{i} > 0 \i \l forward() history + \header \li Input \li Return + \row \li \a{i} < 0 \li \l backward() history + \row \li \a{i} == 0 \li current, see QTextBrowser::source() + \row \li \a{i} > 0 \li \l forward() history \endtable \snippet doc/src/snippets/code/src_gui_widgets_qtextbrowser.cpp 0 diff --git a/src/widgets/widgets/qtextedit.cpp b/src/widgets/widgets/qtextedit.cpp index d0065aacb9..198d101dbf 100644 --- a/src/widgets/widgets/qtextedit.cpp +++ b/src/widgets/widgets/qtextedit.cpp @@ -412,19 +412,19 @@ void QTextEditPrivate::_q_ensureVisible(const QRectF &_rect) When QTextEdit is used read-only the key bindings are limited to navigation, and text may only be selected with the mouse: \table - \header \i Keypresses \i Action - \row \i Up \i Moves one line up. - \row \i Down \i Moves one line down. - \row \i Left \i Moves one character to the left. - \row \i Right \i Moves one character to the right. - \row \i PageUp \i Moves one (viewport) page up. - \row \i PageDown \i Moves one (viewport) page down. - \row \i Home \i Moves to the beginning of the text. - \row \i End \i Moves to the end of the text. - \row \i Alt+Wheel - \i Scrolls the page horizontally (the Wheel is the mouse wheel). - \row \i Ctrl+Wheel \i Zooms the text. - \row \i Ctrl+A \i Selects all text. + \header \li Keypresses \li Action + \row \li Up \li Moves one line up. + \row \li Down \li Moves one line down. + \row \li Left \li Moves one character to the left. + \row \li Right \li Moves one character to the right. + \row \li PageUp \li Moves one (viewport) page up. + \row \li PageDown \li Moves one (viewport) page down. + \row \li Home \li Moves to the beginning of the text. + \row \li End \li Moves to the end of the text. + \row \li Alt+Wheel + \li Scrolls the page horizontally (the Wheel is the mouse wheel). + \row \li Ctrl+Wheel \li Zooms the text. + \row \li Ctrl+A \li Selects all text. \endtable The text edit may be able to provide some meta-information. For @@ -486,31 +486,31 @@ void QTextEditPrivate::_q_ensureVisible(const QRectF &_rect) The list of key bindings which are implemented for editing: \table - \header \i Keypresses \i Action - \row \i Backspace \i Deletes the character to the left of the cursor. - \row \i Delete \i Deletes the character to the right of the cursor. - \row \i Ctrl+C \i Copy the selected text to the clipboard. - \row \i Ctrl+Insert \i Copy the selected text to the clipboard. - \row \i Ctrl+K \i Deletes to the end of the line. - \row \i Ctrl+V \i Pastes the clipboard text into text edit. - \row \i Shift+Insert \i Pastes the clipboard text into text edit. - \row \i Ctrl+X \i Deletes the selected text and copies it to the clipboard. - \row \i Shift+Delete \i Deletes the selected text and copies it to the clipboard. - \row \i Ctrl+Z \i Undoes the last operation. - \row \i Ctrl+Y \i Redoes the last operation. - \row \i Left \i Moves the cursor one character to the left. - \row \i Ctrl+Left \i Moves the cursor one word to the left. - \row \i Right \i Moves the cursor one character to the right. - \row \i Ctrl+Right \i Moves the cursor one word to the right. - \row \i Up \i Moves the cursor one line up. - \row \i Down \i Moves the cursor one line down. - \row \i PageUp \i Moves the cursor one page up. - \row \i PageDown \i Moves the cursor one page down. - \row \i Home \i Moves the cursor to the beginning of the line. - \row \i Ctrl+Home \i Moves the cursor to the beginning of the text. - \row \i End \i Moves the cursor to the end of the line. - \row \i Ctrl+End \i Moves the cursor to the end of the text. - \row \i Alt+Wheel \i Scrolls the page horizontally (the Wheel is the mouse wheel). + \header \li Keypresses \li Action + \row \li Backspace \li Deletes the character to the left of the cursor. + \row \li Delete \li Deletes the character to the right of the cursor. + \row \li Ctrl+C \li Copy the selected text to the clipboard. + \row \li Ctrl+Insert \li Copy the selected text to the clipboard. + \row \li Ctrl+K \li Deletes to the end of the line. + \row \li Ctrl+V \li Pastes the clipboard text into text edit. + \row \li Shift+Insert \li Pastes the clipboard text into text edit. + \row \li Ctrl+X \li Deletes the selected text and copies it to the clipboard. + \row \li Shift+Delete \li Deletes the selected text and copies it to the clipboard. + \row \li Ctrl+Z \li Undoes the last operation. + \row \li Ctrl+Y \li Redoes the last operation. + \row \li Left \li Moves the cursor one character to the left. + \row \li Ctrl+Left \li Moves the cursor one word to the left. + \row \li Right \li Moves the cursor one character to the right. + \row \li Ctrl+Right \li Moves the cursor one word to the right. + \row \li Up \li Moves the cursor one line up. + \row \li Down \li Moves the cursor one line down. + \row \li PageUp \li Moves the cursor one page up. + \row \li PageDown \li Moves the cursor one page down. + \row \li Home \li Moves the cursor to the beginning of the line. + \row \li Ctrl+Home \li Moves the cursor to the beginning of the text. + \row \li End \li Moves the cursor to the end of the line. + \row \li Ctrl+End \li Moves the cursor to the end of the text. + \row \li Alt+Wheel \li Scrolls the page horizontally (the Wheel is the mouse wheel). \endtable To select (mark) text hold down the Shift key whilst pressing one diff --git a/src/widgets/widgets/qtoolbutton.cpp b/src/widgets/widgets/qtoolbutton.cpp index 015419a879..68a4f20fb6 100644 --- a/src/widgets/widgets/qtoolbutton.cpp +++ b/src/widgets/widgets/qtoolbutton.cpp @@ -159,8 +159,8 @@ bool QToolButtonPrivate::hasMenu() const adjust it with setPopupDelay(). \table 100% - \row \o \inlineimage assistant-toolbar.png Qt Assistant's toolbar with tool buttons - \row \o Qt Assistant's toolbar contains tool buttons that are associated + \row \li \inlineimage assistant-toolbar.png Qt Assistant's toolbar with tool buttons + \row \li Qt Assistant's toolbar contains tool buttons that are associated with actions used in other parts of the main window. \endtable diff --git a/src/widgets/widgets/qworkspace.cpp b/src/widgets/widgets/qworkspace.cpp index 5cc8e363f1..36c589be1c 100644 --- a/src/widgets/widgets/qworkspace.cpp +++ b/src/widgets/widgets/qworkspace.cpp @@ -878,8 +878,8 @@ QSize QWorkspaceTitleBar::sizeHint() const connect menu entries to them. \table - \row \o \inlineimage mdi-cascade.png - \o \inlineimage mdi-tile.png + \row \li \inlineimage mdi-cascade.png + \li \inlineimage mdi-tile.png \endtable If you want your users to be able to work with child windows |