qtmobility/src/contacts/qcontactabstractrequest.cpp
changeset 5 453da2cfceef
parent 4 90517678cc4f
child 11 06b8e2af4411
equal deleted inserted replaced
4:90517678cc4f 5:453da2cfceef
    54   asynchronous requests to be made of a manager if it supports them.
    54   asynchronous requests to be made of a manager if it supports them.
    55 
    55 
    56   \ingroup contacts-main
    56   \ingroup contacts-main
    57 
    57 
    58   It allows a client to asynchronously request some functionality of a
    58   It allows a client to asynchronously request some functionality of a
    59   particular QContactManager.
    59   particular QContactManager.  Instances of the class will emit signals
       
    60   when the state of the request changes, or when more results become
       
    61   available.
       
    62 
       
    63   Clients should not attempt to create instances of this class directly,
       
    64   but should instead use the use-case-specific classes derived from this
       
    65   class.
       
    66 
       
    67   After creating any sort of request, the client retains ownership and
       
    68   must delete the request to avoid leaking memory.  The client may either
       
    69   do this directly (if not within a slot connected to a signal emitted
       
    70   by the request) or by using the deleteLater() slot to schedule the
       
    71   request for deletion when control returns to the event loop.
    60  */
    72  */
    61 
    73 
    62 /*!
    74 /*!
    63   \fn QContactAbstractRequest::stateChanged(QContactAbstractRequest::State newState)
    75   \fn QContactAbstractRequest::stateChanged(QContactAbstractRequest::State newState)
    64   This signal is emitted when the state of the request is changed.  The new state of
    76   This signal is emitted when the state of the request is changed.  The new state of
    99   \value CanceledState Operation is finished due to cancellation
   111   \value CanceledState Operation is finished due to cancellation
   100   \value FinishedState Operation successfully completed
   112   \value FinishedState Operation successfully completed
   101  */
   113  */
   102 
   114 
   103 /*!
   115 /*!
   104   \fn QContactAbstractRequest::QContactAbstractRequest()
   116   \fn QContactAbstractRequest::QContactAbstractRequest(QObject* parent)
   105   Constructs a new, invalid asynchronous request
   117   Constructs a new, invalid asynchronous request with the specified \a parent
   106  */
   118  */
   107 
   119 
   108 /*!
   120 /*!
   109   \internal
   121   \internal
   110   Constructs a new request from the given request data \a otherd
   122   Constructs a new request from the given request data \a otherd with
       
   123   the given parent \a parent
   111 */
   124 */
   112 QContactAbstractRequest::QContactAbstractRequest(QContactAbstractRequestPrivate* otherd)
   125 QContactAbstractRequest::QContactAbstractRequest(QContactAbstractRequestPrivate* otherd, QObject* parent)
   113     : d_ptr(otherd)
   126     : QObject(parent), d_ptr(otherd)
   114 {
   127 {
   115 }
   128 }
   116 
   129 
   117 /*! Cleans up the memory used by this request */
   130 /*! Cleans up the memory used by this request */
   118 QContactAbstractRequest::~QContactAbstractRequest()
   131 QContactAbstractRequest::~QContactAbstractRequest()