Contacts Asynchronous API

Fetching Contacts

The client sets up a request for contacts matching a specific criteria from a particular manager.

Results from the request will be displayed to the user as they are received.

 void RequestExample::performRequest()
 {
     // retrieve any contact whose first name is "Alice"
     QContactDetailFilter dfil;
     dfil.setDetailType(QContactName::Type, QContactName::FieldFirstName);
     dfil.setValue("Alice");
     dfil.setMatchFlags(QContactFilter::MatchExactly);

     // m_fetchRequest was created with m_fetchRequest = new QContactFetchRequest() in the ctor.
     m_fetchRequest->setManager(this->m_manager); // m_manager is a QContactManager*.
     m_fetchRequest->setFilter(dfil);
     connect(m_fetchRequest, SIGNAL(resultsAvailable()), this, SLOT(printContacts()));
     connect(m_fetchRequest, SIGNAL(stateChanged(QContactAbstractRequest::State)),
             this, SLOT(stateChanged(QContactAbstractRequest::State)));
     if (!m_fetchRequest->start()) {
         qDebug() << "Unable to request contacts!";
         QCoreApplication::exit(0);
     } else {
         qDebug() << "Requested contacts; awaiting results...";
     }
 }

 void RequestExample::printContacts()
 {
     QList<QContact> results = m_fetchRequest->contacts();
     for (m_previousLastIndex = 0; m_previousLastIndex < results.size(); ++m_previousLastIndex) {
         qDebug() << "Found an Alice:" << results.at(m_previousLastIndex).displayLabel();
     }
 }

 void RequestExample::stateChanged(QContactAbstractRequest::State state)
 {
     // once we've finished retrieving results, stop processing events.
     if (state == QContactAbstractRequest::FinishedState
         || state == QContactAbstractRequest::CanceledState) {
         qDebug() << "Finished displaying asynchronously retrieved contacts!";
         QCoreApplication::exit(0);
     }
 }