summaryrefslogtreecommitdiffstats
path: root/doc/src/classes/qnamespace.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/classes/qnamespace.qdoc')
-rw-r--r--doc/src/classes/qnamespace.qdoc55
1 files changed, 33 insertions, 22 deletions
diff --git a/doc/src/classes/qnamespace.qdoc b/doc/src/classes/qnamespace.qdoc
index a49e079..79a4560 100644
--- a/doc/src/classes/qnamespace.qdoc
+++ b/doc/src/classes/qnamespace.qdoc
@@ -34,7 +34,7 @@
** met: http://www.gnu.org/copyleft/gpl.html.
**
** If you are unsure which license is appropriate for your use, please
-** contact the sales department at http://www.qtsoftware.com/contact.
+** contact the sales department at http://qt.nokia.com/contact.
** $QT_END_LICENSE$
**
****************************************************************************/
@@ -490,6 +490,7 @@
\omitvalue WordBreak
\omitvalue TextForceLeftToRight
\omitvalue TextForceRightToLeft
+ \omitvalue TextLongestVariant Always use the longest variant when computing the size of a multi-variant string
You can use as many modifier flags as you want, except that
Qt::TextSingleLine and Qt::TextWordWrap cannot be combined.
@@ -514,7 +515,6 @@
slots. In particular, it determines whether a particular signal is delivered to a
slot immediately or queued for delivery at a later time.
- \omitvalue AutoCompatConnection
\value DirectConnection When emitted, the signal is immediately delivered to the slot.
\value QueuedConnection When emitted, the signal is queued until the event loop is
able to deliver it to the slot.
@@ -533,6 +533,12 @@
not already connected to the same slot before connecting, otherwise,
the connection will fail.
This value was introduced in Qt 4.6.
+ \value AutoCompatConnection
+ The default connection type for signals and slots when Qt 3 support
+ is enabled. Equivalent to AutoConnection for connections but will cause warnings
+ to be output under certain circumstances. See
+ \l{Porting to Qt 4#Compatibility Signals and Slots}{Compatibility Signals and Slots}
+ for further information.
With queued connections, the parameters must be of types that are known to
Qt's meta-object system, because Qt needs to copy the arguments to store them
@@ -2458,44 +2464,46 @@
Each item in the model has a set of data elements associated with
it, each with its own role. The roles are used by the view to indicate
- to the model which type of data it needs.
+ to the model which type of data it needs. Custom models should return
+ data in these types.
- The general purpose roles are:
+ The general purpose roles (and the associated types) are:
- \value DisplayRole The key data to be rendered in the form of text.
+ \value DisplayRole The key data to be rendered in the form of text. (QString)
\value DecorationRole The data to be rendered as a decoration in the form
- of an icon.
+ of an icon. (QColor)
\value EditRole The data in a form suitable for editing in an
- editor.
- \value ToolTipRole The data displayed in the item's tooltip.
- \value StatusTipRole The data displayed in the status bar.
+ editor. (QString)
+ \value ToolTipRole The data displayed in the item's tooltip. (QString)
+ \value StatusTipRole The data displayed in the status bar. (QString)
\value WhatsThisRole The data displayed for the item in "What's This?"
- mode.
+ mode. (QString)
\value SizeHintRole The size hint for the item that will be supplied
- to views.
+ to views. (QSize)
- Roles describing appearance and meta data:
+ Roles describing appearance and meta data (with associated types):
\value FontRole The font used for items rendered with the default
- delegate.
+ delegate. (QFont)
\value TextAlignmentRole The alignment of the text for items rendered with the
- default delegate.
+ default delegate. (Qt::AlignmentFlag)
\value BackgroundRole The background brush used for items rendered with
- the default delegate.
+ the default delegate. (QBrush)
\value BackgroundColorRole This role is obsolete. Use BackgroundRole instead.
\value ForegroundRole The foreground brush (text color, typically)
used for items rendered with the default delegate.
+ (QBrush)
\value TextColorRole This role is obsolete. Use ForegroundRole instead.
\value CheckStateRole This role is used to obtain the checked state of
- an item (see \l Qt::CheckState).
+ an item. (Qt::CheckState)
- Accessibility roles:
+ Accessibility roles (with associated types):
\value AccessibleTextRole The text to be used by accessibility
extensions and plugins, such as screen
- readers.
+ readers. (QString)
\value AccessibleDescriptionRole A description of the item for accessibility
- purposes.
+ purposes. (QString)
User roles:
@@ -2506,6 +2514,9 @@
\omitvalue ToolTipPropertyRole
\omitvalue StatusTipPropertyRole
\omitvalue WhatsThisPropertyRole
+
+ For user roles, it is up to the developer to decide which types to use and ensure that
+ components use the correct types when accessing and setting data.
*/
/*!
@@ -2569,10 +2580,10 @@
\value ElideNone Ellipsis should NOT appear in the text.
Qt::ElideMiddle is normally the most appropriate choice for URLs (e.g.,
- "\l{http://www.qtsoftware.com/careers/movingto/beijing/}{http://www.qtsof...ovingto/beijing/}"),
+ "\l{http://qt.nokia.com/careers/movingto/brisbane/}{http://qt.nok...ovingto/brisbane/}"),
whereas Qt::ElideRight is appropriate
for other strings (e.g.,
- "\l{http://doc.trolltech.com/qq/qq09-mac-deployment.html}{Deploying Applications on Ma...}").
+ "\l{http://qt.nokia.com/doc/qq/qq09-mac-deployment.html}{Deploying Applications on Ma...}").
\sa QAbstractItemView::textElideMode, QFontMetrics::elidedText(), AlignmentFlag QTabBar::elideMode
*/
@@ -2736,7 +2747,7 @@
This enum type describes the state of a gesture.
- \omitvalue NoGesture
+ \value NoGesture Initial state
\value GestureStarted A continuous gesture has started.
\value GestureUpdated A gesture continues.
\value GestureFinished A gesture has finished.