QContact Class Reference

QList<QContactDetail> QContact::details ( const QString & definitionName = QString() ) const

Returns a list of details with the given definitionName The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by requesting a list of all the definitions synchronously with detailDefinitions() or asynchronously with a detail definition fetch request, and then inspecting the name() of each definition. If definitionName is empty, all details of any definition will be returned.

QList<QContactDetail> QContact::details ( const QString & definitionName, const QString & fieldName, const QString & value ) const

Returns a list of details of the given definitionName, with fields named fieldName and with value value. The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g. QContactPhoneNumber::DefinitionName) or by requesting a list of all the definitions synchronously with detailDefinitions() or asynchronously with a detail definition fetch request, and then inspecting the name() of each definition. If definitionName is empty, all details of any definition will be returned.

QList<QContactDetail> QContact::details ( const QLatin1Constant & definitionName ) const

Returns a list of details of the given definitionName.

The definitionName argument is typically the detail name constant provided by a specific subclass of QContactDetail. For example:

            QList<QContactDetail> details = contact.details(QContactPhoneNumber::DefinitionName);

It would usually be more convenient to use the template version of this function, in the following manner:

            QList<QContactPhoneNumber> phoneNumbers = contact.details<QContactPhoneNumber>();

QList<QContactDetail> QContact::details ( const QLatin1Constant & definitionName, const QLatin1Constant & fieldName, const QString & value )

Returns a list of details of the given definitionName, with fields named fieldName and with value value.

QList<T> QContact::details () const

Returns a list of details of the template parameter type. The type must be a subclass of QContactDetail.

For example:

            QList<QContactPhoneNumber> phoneNumbers = contact.details<QContactPhoneNumber>();

QList<T> QContact::details ( const QString & fieldName, const QString & value ) const

Returns a list of details of the template parameter type which have field called fieldName, with matching value. The type must be a subclass of QContactDetail.

For example:

            QList<QContactPhoneNumber> homePhones = contact.details<QContactPhoneNumber>("Context", "Home");

        /* Retrieve a contact */
        QContact c = manager->contact(myId);
        qDebug() << "Current display label" << c.displayLabel();

        /* Update some fields that might influence the display label */
        QContactName name = c.detail<QContactName>();
        name.setFirstName("Abigail");
        name.setLastName("Arkansas");
        c.saveDetail(&name);

        /* Update the display label */
        manager->synthesizeContactDisplayLabel(&c);
        qDebug() << "Now the label is:" << c.displayLabel();

            // Who are the members of a group contact?
            QList<QContactId> groupMembers = groupContact.relatedContacts(QContactRelationship::HasMember, QContactRelationship::Second);
            // What groups is this contact in?
            QList<QContactId> contactGroups = contact.relatedContacts(QContactRelationship::HasMember, QContactRelationship::First);
            // An alternative to QContact::relationships()
            QList<QContactId> spouses = contact.relatedContacts(QContactRelationship::HasSpouse, QContactRelationship::Either);
            if (spouses.count() > 1) {
                // Custom relationship type
                QList<QContactId> therapists = contact.relatedContacts("HasTherapist", QContactRelationship::Second);
            }

            QList<QContactRelationship> spouseRelationships = contact.relationships(QContactRelationship::HasSpouse);
            // For each relationship in spouseRelationships, contact.id() will either be first() or second()