FCL/sf/mw/qt: comparison src/corelib/global/qnamespace.qdoc

equal deleted inserted replaced

-:41300fa6a67c
+:f7bc934e204c
 /****************************************************************************
 **
-** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
 ** This file is part of the documentation of the Qt Toolkit.
 **
 has no effect.
 \value AA_DontShowIconsInMenus Actions with the Icon property won't be
 shown in any menus unless specifically set by the
 QAction::iconVisibleInMenu property.
 Menus that are currently open or menus already created in the native
 Mac OS X menubar \e{may not} pick up a change in this attribute. Changes
 in the QAction::iconVisibleInMenu property will always be picked up.
 \value AA_NativeWindows Ensures that widgets have native windows.
 set to true won't be used as a native menubar (e.g, the menubar at
 the top of the main screen on Mac OS X or at the bottom in Windows CE).
 \value AA_MacDontSwapCtrlAndMeta On Mac OS X by default, Qt swaps the
 Control and Meta (Command) keys (i.e., whenever Control is pressed, Qt
-sends Meta and whenever Meta is pressed Control is sent. When this
+sends Meta, and whenever Meta is pressed Control is sent). When this
 attribute is true, Qt will not do the flip. QKeySequence::StandardShortcuts
 will also flip accordingly (i.e., QKeySequence::Copy will be
 Command+C on the keyboard regardless of the value set, though what is output for
 QKeySequence::toString(QKeySequence::PortableText) will be different).
+\value AA_S60DontConstructApplicationPanes Stops Qt from initializing the S60 status
+pane and softkey pane on Symbian. This is useful to save memory and reduce
+startup time for applications that will run in fullscreen mode during their
+whole lifetime. This attribute must be set before QApplication is
+constructed.
 \omitvalue AA_AttributeCount
 */
 /*!
 \omitvalue ShowPrefix
 \omitvalue SingleLine
 \omitvalue WordBreak
 \omitvalue TextForceLeftToRight
 \omitvalue TextForceRightToLeft
-\omitvalue TextLongestVariant Always use the longest variant when computing the size of a multi-variant string
+\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.
 Flags that are inappropriate for a given use are generally
 */
 /*!
 \enum Qt::ConnectionType
-This enum describes the types of connection that can be used between signals and
+This enum describes the types of connection that can be used
-slots. In particular, it determines whether a particular signal is delivered to a
+between signals and slots. In particular, it determines whether a
-slot immediately or queued for delivery at a later time.
+particular signal is delivered to a slot immediately or queued for
+delivery at a later time.
-\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
+\value AutoConnection
-able to deliver it to the slot.
+	   (default) Same as DirectConnection, if the emitter and
+	   receiver are in the same thread. Same as QueuedConnection,
+	   if the emitter and receiver are in different threads.
+\value DirectConnection
+	   The slot is invoked immediately, when the signal is
+	   emitted.
+\value QueuedConnection
+	   The slot is invoked when control returns to the event loop
+	   of the receiver's thread. The slot is executed in the
+	   receiver's thread.
 \value BlockingQueuedConnection
-Same as QueuedConnection, except that the current thread blocks
+Same as QueuedConnection, except the current thread blocks
-until the slot has been delivered. This connection type should
+until the slot returns. This connection type should only be
-only be used for receivers in a different thread. Note that misuse
+used where the emitter and receiver are in different
-of this type can lead to deadlocks in your application.
+threads.  \note Violating this rule can cause your
-\value AutoConnection    If the signal is emitted from the thread
+application to deadlock.
-in which the receiving object lives, the
-slot is invoked directly, as with
+\value UniqueConnection
-Qt::DirectConnection; otherwise the
+Same as AutoConnection, but the connection is made only if
-signal is queued, as with
+	   it does not duplicate an existing connection. i.e., if the
-Qt::QueuedConnection.
+	   same signal is already connected to the same slot for the
-\value UniqueConnection  Same as AutoConnection, but there will be a check that the signal is
+	   same pair of objects, then the connection will fail. This
-not already connected to the same slot before connecting, otherwise,
+	   connection type was introduced in Qt 4.6.
-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
+	   The default type when Qt 3 support is enabled. Same as
-is enabled. Equivalent to AutoConnection for connections but will cause warnings
+	   AutoConnection but will also cause warnings to be output in
-to be output under certain circumstances. See
+	   certain situations. See \l{Porting to Qt 4#Compatibility
-\l{Porting to Qt 4#Compatibility Signals and Slots}{Compatibility Signals and Slots}
+	   Signals and Slots}{Compatibility Signals and Slots} for
-for further information.
+	   further information.
-With queued connections, the parameters must be of types that are known to
+With queued connections, the parameters must be of types that are
-Qt's meta-object system, because Qt needs to copy the arguments to store them
+known to Qt's meta-object system, because Qt needs to copy the
-in an event behind the scenes. If you try to use a queued connection and
+arguments to store them in an event behind the scenes. If you try
-get the error message
+to use a queued connection and get the error message:
 \snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 0
-call qRegisterMetaType() to register the data type before you
+Call qRegisterMetaType() to register the data type before you
 establish the connection.
+When using signals and slots with multiple threads, see \l{Signals and Slots Across Threads}.
 \sa {Thread Support in Qt}, QObject::connect(), qRegisterMetaType()
 */
 /*!
 handle touch events. Without this attribute set, events from a
 touch device will be sent as mouse events.
 \value WA_TouchPadAcceptSingleTouchEvents Allows touchpad single
 touch events to be sent to the widget.
+\value WA_MergeSoftkeys Allows widget to merge softkeys with parent widget,
+i.e. widget can set only one softkeys and request softkey implementation
+to take rest of the softkeys from the parent. Note parents are traversed until
+WA_MergeSoftkeys is not set. See also Qt::WA_MergeSoftkeysRecursively
+This attribute currently has effect only on Symbian platforms
+\value WA_MergeSoftkeysRecursively Allows widget to merge softkeys recursively
+with all parents. If this attribute is set, the widget parents are traversed until
+window boundary (widget without parent or dialog) is found.
+This attribute currently has effect only on Symbian platforms
 \omitvalue WA_SetLayoutDirection
 \omitvalue WA_InputMethodTransparent
 \omitvalue WA_WState_CompressKeys
 \omitvalue WA_WState_ConfigPending
 \value Key_Search
 \value Key_Standby
 \value Key_OpenUrl
 \value Key_LaunchMail
 \value Key_LaunchMedia
-\value Key_Launch0
+\value Key_Launch0 On X11 this key is mapped to "My Computer" (XF86XK_MyComputer) key for legacy reasons.
-\value Key_Launch1
+\value Key_Launch1 On X11 this key is mapped to "Calculator" (XF86XK_Calculator) key for legacy reasons.
-\value Key_Launch2
+\value Key_Launch2 On X11 this key is mapped to XF86XK_Launch0 key for legacy reasons.
-\value Key_Launch3
+\value Key_Launch3 On X11 this key is mapped to XF86XK_Launch1 key for legacy reasons.
-\value Key_Launch4
+\value Key_Launch4 On X11 this key is mapped to XF86XK_Launch2 key for legacy reasons.
-\value Key_Launch5
+\value Key_Launch5 On X11 this key is mapped to XF86XK_Launch3 key for legacy reasons.
-\value Key_Launch6
+\value Key_Launch6 On X11 this key is mapped to XF86XK_Launch4 key for legacy reasons.
-\value Key_Launch7
+\value Key_Launch7 On X11 this key is mapped to XF86XK_Launch5 key for legacy reasons.
-\value Key_Launch8
+\value Key_Launch8 On X11 this key is mapped to XF86XK_Launch6 key for legacy reasons.
-\value Key_Launch9
+\value Key_Launch9 On X11 this key is mapped to XF86XK_Launch7 key for legacy reasons.
-\value Key_LaunchA
+\value Key_LaunchA On X11 this key is mapped to XF86XK_Launch8 key for legacy reasons.
-\value Key_LaunchB
+\value Key_LaunchB On X11 this key is mapped to XF86XK_Launch9 key for legacy reasons.
-\value Key_LaunchC
+\value Key_LaunchC On X11 this key is mapped to XF86XK_LaunchA key for legacy reasons.
-\value Key_LaunchD
+\value Key_LaunchD On X11 this key is mapped to XF86XK_LaunchB key for legacy reasons.
-\value Key_LaunchE
+\value Key_LaunchE On X11 this key is mapped to XF86XK_LaunchC key for legacy reasons.
-\value Key_LaunchF
+\value Key_LaunchF On X11 this key is mapped to XF86XK_LaunchD key for legacy reasons.
 \value Key_MonBrightnessUp
 \value Key_MonBrightnessDown
 \value Key_KeyboardLightOnOff
 \value Key_KeyboardBrightnessUp
 \value Key_KeyboardBrightnessDown
 \value Key_BackForward
 \value Key_ApplicationLeft
 \value Key_ApplicationRight
 \value Key_Book
 \value Key_CD
-\value Key_Calculator
+\value Key_Calculator On X11 this key is not mapped for legacy reasons. Use Qt::Key_Launch1 instead.
 \value Key_ToDoList
 \value Key_ClearGrab
 \value Key_Close
 \value Key_Copy
 \value Key_Cut
 \value WindowContextHelpButtonHint  Adds a context help button to dialogs.
 On some platforms this implies Qt::WindowSystemMenuHint for it to work.
 \value MacWindowToolBarButtonHint On Mac OS X adds a tool bar button (i.e.,
-the oblong button that is on the top right of windows that have toolbars.
+the oblong button that is on the top right of windows that have toolbars).
 \value BypassGraphicsProxyWidget Prevents the window and its children from
 automatically embedding themselves into a QGraphicsProxyWidget if the
 parent widget is already embedded. You can set this flag if you
 want your widget to always be a toplevel widget on the desktop,
 \value WindowOkButtonHint Adds an OK button to the window decoration of a dialog.
 Only supported for Windows CE.
 \value WindowCancelButtonHint Adds a Cancel button to the window decoration of a dialog.
 Only supported for Windows CE.
+\value WindowSoftkeysVisibleHint Makes softkeys visible when widget is fullscreen.
+Only supported for Symbian.
+\value WindowSoftkeysRespondHint Makes softkeys to receive key events even
+when invisible. With this hint the softkey actions are triggered
+even the softkeys are invisible i.e. the window is displayed with
+\c showFullscreen(). Only supported for Symbian.
 \value WindowType_Mask  A mask for extracting the window type
 part of the window flags.
 Obsolete flags:

changeset 7	f7bc934e204c
parent 3	41300fa6a67c