diff options
| author | Leena Miettinen <riitta-leena.miettinen@qt.io> | 2017-01-17 11:33:38 +0100 |
|---|---|---|
| committer | Leena Miettinen <riitta-leena.miettinen@qt.io> | 2017-01-19 09:32:33 +0000 |
| commit | 11875b89f4806264ab16d511c132f2f11ac36e6b (patch) | |
| tree | 4caa6efe4a0289ca4b246a6094aa75252f534000 | |
| parent | 231259c3d519a55880563b12f5796723fa99e522 (diff) | |
Doc: Fix issues in QStyleHints documentation
The \c command is not supported within the \brief command.
If used, QDoc omits the value and the command. Rewrite briefs
to avoid using the \c command in them.
Task-number: QTBUG-58212
Change-Id: Ia29eae8b17a5fd46bec39e113aabf22e010217a4
Reviewed-by: J-P Nurmi <jpnurmi@qt.io>
Reviewed-by: Nico Vertriest <nico.vertriest@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
| -rw-r--r-- | src/gui/kernel/qstylehints.cpp | 24 |
1 files changed, 18 insertions, 6 deletions
diff --git a/src/gui/kernel/qstylehints.cpp b/src/gui/kernel/qstylehints.cpp index 7ccf1d86b0..22c077da41 100644 --- a/src/gui/kernel/qstylehints.cpp +++ b/src/gui/kernel/qstylehints.cpp @@ -329,7 +329,9 @@ int QStyleHints::cursorFlashTime() const /*! \property QStyleHints::showIsFullScreen - \brief \c true if the platform defaults to windows being fullscreen, + \brief whether the platform defaults to fullscreen windows. + + This property is \c true if the platform defaults to windows being fullscreen, otherwise \c false. \note The platform may still choose to show certain windows non-fullscreen, @@ -344,7 +346,9 @@ bool QStyleHints::showIsFullScreen() const /*! \property QStyleHints::showIsMaximized - \brief \c true if the platform defaults to windows being maximized, + \brief whether the platform defaults to maximized windows. + + This property is \c true if the platform defaults to windows being maximized, otherwise \c false. \note The platform may still choose to show certain windows non-maximized, @@ -389,7 +393,9 @@ qreal QStyleHints::fontSmoothingGamma() const /*! \property QStyleHints::useRtlExtensions - \brief \c true if right-to-left writing direction is enabled, + \brief the writing direction. + + This property is \c true if right-to-left writing direction is enabled, otherwise \c false. */ bool QStyleHints::useRtlExtensions() const @@ -399,7 +405,9 @@ bool QStyleHints::useRtlExtensions() const /*! \property QStyleHints::setFocusOnTouchRelease - \brief \c true if focus objects (line edits etc) should receive + \brief the event that should set input focus on focus objects. + + This property is \c true if focus objects (line edits etc) should receive input focus after a touch/mouse release. This is normal behavior on touch platforms. On desktop platforms, the standard is to set focus already on touch/mouse press. @@ -443,7 +451,9 @@ void QStyleHints::setTabFocusBehavior(Qt::TabFocusBehavior tabFocusBehavior) /*! \property QStyleHints::singleClickActivation - \brief \c true if items should be activated by single click, \b false + \brief whether items are activated by single or double click. + + This property is \c true if items should be activated by single click, \c false if they should be activated by double click instead. \since 5.5 @@ -455,7 +465,9 @@ bool QStyleHints::singleClickActivation() const /*! \property QStyleHints::useHoverEffects - \brief \c true if UI elements should use hover effects. This is the + \brief whether UI elements use hover effects. + + This property is \c true if UI elements should use hover effects. This is the standard behavior on desktop platforms with a mouse pointer, whereas on touch platforms the overhead of hover event delivery can be avoided. |