src/corelib/global/qnamespace.qdoc
branchRCL_3
changeset 4 3b1da2848fc7
parent 3 41300fa6a67c
child 5 d3bac044e0f0
equal deleted inserted replaced
3:41300fa6a67c 4:3b1da2848fc7
     1 /****************************************************************************
     1 /****************************************************************************
     2 **
     2 **
     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
     4 ** All rights reserved.
     4 ** All rights reserved.
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
     6 **
     6 **
     7 ** This file is part of the documentation of the Qt Toolkit.
     7 ** This file is part of the documentation of the Qt Toolkit.
     8 **
     8 **
   132            has no effect.
   132            has no effect.
   133 
   133 
   134     \value AA_DontShowIconsInMenus Actions with the Icon property won't be
   134     \value AA_DontShowIconsInMenus Actions with the Icon property won't be
   135            shown in any menus unless specifically set by the
   135            shown in any menus unless specifically set by the
   136            QAction::iconVisibleInMenu property.
   136            QAction::iconVisibleInMenu property.
   137 
       
   138            Menus that are currently open or menus already created in the native
   137            Menus that are currently open or menus already created in the native
   139            Mac OS X menubar \e{may not} pick up a change in this attribute. Changes
   138            Mac OS X menubar \e{may not} pick up a change in this attribute. Changes
   140            in the QAction::iconVisibleInMenu property will always be picked up.
   139            in the QAction::iconVisibleInMenu property will always be picked up.
   141 
   140 
   142     \value AA_NativeWindows Ensures that widgets have native windows.
   141     \value AA_NativeWindows Ensures that widgets have native windows.
   161            sends Meta and whenever Meta is pressed Control is sent. When this
   160            sends Meta and whenever Meta is pressed Control is sent. When this
   162            attribute is true, Qt will not do the flip. QKeySequence::StandardShortcuts
   161            attribute is true, Qt will not do the flip. QKeySequence::StandardShortcuts
   163            will also flip accordingly (i.e., QKeySequence::Copy will be
   162            will also flip accordingly (i.e., QKeySequence::Copy will be
   164            Command+C on the keyboard regardless of the value set, though what is output for
   163            Command+C on the keyboard regardless of the value set, though what is output for
   165            QKeySequence::toString(QKeySequence::PortableText) will be different).
   164            QKeySequence::toString(QKeySequence::PortableText) will be different).
       
   165 
       
   166     \value AA_S60DontConstructApplicationPanes Stops Qt from initializing the S60 status
       
   167            pane and softkey pane on Symbian. This is useful to save memory and reduce
       
   168            startup time for applications that will run in fullscreen mode during their
       
   169            whole lifetime. This attribute must be set before QApplication is
       
   170            constructed.
   166 
   171 
   167     \omitvalue AA_AttributeCount
   172     \omitvalue AA_AttributeCount
   168 */
   173 */
   169 
   174 
   170 /*!
   175 /*!
   507 */
   512 */
   508 
   513 
   509 /*!
   514 /*!
   510     \enum Qt::ConnectionType
   515     \enum Qt::ConnectionType
   511 
   516 
   512     This enum describes the types of connection that can be used between signals and
   517     This enum describes the types of connection that can be used
   513     slots. In particular, it determines whether a particular signal is delivered to a
   518     between signals and slots. In particular, it determines whether a
   514     slot immediately or queued for delivery at a later time.
   519     particular signal is delivered to a slot immediately or queued for
   515 
   520     delivery at a later time.
   516     \value DirectConnection  When emitted, the signal is immediately delivered to the slot.
   521 
   517     \value QueuedConnection  When emitted, the signal is queued until the event loop is
   522     \value AutoConnection
   518                              able to deliver it to the slot.
   523     	   (default) Same as DirectConnection, if the emitter and
       
   524        	   receiver are in the same thread. Same as QueuedConnection,
       
   525        	   if the emitter and receiver are in different threads.
       
   526 
       
   527     \value DirectConnection  
       
   528 	   The slot is invoked immediately, when the signal is
       
   529        	   emitted.
       
   530 
       
   531     \value QueuedConnection  
       
   532     	   The slot is invoked when control returns to the event loop
       
   533        	   of the receiver's thread. The slot is executed in the
       
   534        	   receiver's thread.
       
   535 
   519     \value BlockingQueuedConnection
   536     \value BlockingQueuedConnection
   520                              Same as QueuedConnection, except that the current thread blocks
   537            Same as QueuedConnection, except the current thread blocks
   521                              until the slot has been delivered. This connection type should
   538            until the slot returns. This connection type should only be
   522                              only be used for receivers in a different thread. Note that misuse
   539            used where the emitter and receiver are in different
   523                              of this type can lead to deadlocks in your application.
   540            threads.  \note Violating this rule can cause your
   524     \value AutoConnection    If the signal is emitted from the thread
   541            application to deadlock.
   525                              in which the receiving object lives, the
   542 
   526                              slot is invoked directly, as with
   543     \value UniqueConnection
   527                              Qt::DirectConnection; otherwise the
   544            Same as AutoConnection, but the connection is made only if
   528                              signal is queued, as with
   545     	   it does not duplicate an existing connection. i.e., if the
   529                              Qt::QueuedConnection.
   546     	   same signal is already connected to the same slot for the
   530     \value UniqueConnection  Same as AutoConnection, but there will be a check that the signal is
   547     	   same pair of objects, then the connection will fail. This
   531                              not already connected to the same slot before connecting, otherwise,
   548     	   connection type was introduced in Qt 4.6.
   532                              the connection will fail.
   549 
   533                              This value was introduced in Qt 4.6.
       
   534     \value AutoCompatConnection
   550     \value AutoCompatConnection
   535            The default connection type for signals and slots when Qt 3 support
   551     	   The default type when Qt 3 support is enabled. Same as
   536            is enabled. Equivalent to AutoConnection for connections but will cause warnings
   552 	   AutoConnection but will also cause warnings to be output in
   537            to be output under certain circumstances. See
   553 	   certain situations. See \l{Porting to Qt 4#Compatibility
   538            \l{Porting to Qt 4#Compatibility Signals and Slots}{Compatibility Signals and Slots}
   554 	   Signals and Slots}{Compatibility Signals and Slots} for
   539            for further information.
   555 	   further information.
   540 
   556 
   541     With queued connections, the parameters must be of types that are known to
   557     With queued connections, the parameters must be of types that are
   542     Qt's meta-object system, because Qt needs to copy the arguments to store them
   558     known to Qt's meta-object system, because Qt needs to copy the
   543     in an event behind the scenes. If you try to use a queued connection and
   559     arguments to store them in an event behind the scenes. If you try
   544     get the error message
   560     to use a queued connection and get the error message:
   545 
   561 
   546     \snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 0
   562     \snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 0
   547 
   563 
   548     call qRegisterMetaType() to register the data type before you
   564     Call qRegisterMetaType() to register the data type before you
   549     establish the connection.
   565     establish the connection.
       
   566 
       
   567     When using signals and slots with multiple threads, see \l{Signals and Slots Across Threads}.
   550 
   568 
   551     \sa {Thread Support in Qt}, QObject::connect(), qRegisterMetaType()
   569     \sa {Thread Support in Qt}, QObject::connect(), qRegisterMetaType()
   552 */
   570 */
   553 
   571 
   554 /*!
   572 /*!