Home · All Classes · All Functions ·

QContactPresence Class Reference

The QContactPresence class provides presence information for an online account of a contact. More...

    #include <QContactPresence>

Inherits QContactDetail.

Public Types

Public Functions

Static Public Members


Detailed Description

The QContactPresence class provides presence information for an online account of a contact.

Presence information for a particular QContactOnlineAccount detail is provided in a QContactPresence detail which is linked (via linkedDetailUris()) to the account detail. This information is generally provided by the backend, and is not modifiable by clients.

Presence information can include update timestamp, screen name, and the status icon, status value, and status text provided by the service provider, as well as user defined status message.

See also QContactOnlineAccount.


Member Type Documentation

enum QContactPresence::PresenceState

This enum defines the possible presence states supported by the default schema. Not all presence providers support all of these states.

ConstantValueDescription
QContactPresence::PresenceUnknown0Signifies that the presence state of the contact is not currently known
QContactPresence::PresenceAvailable1Signifies that the contact is available
QContactPresence::PresenceHidden2Signifies that the contact is hidden
QContactPresence::PresenceBusy3Signifies that the contact is busy
QContactPresence::PresenceAway4Signifies that the contact is away
QContactPresence::PresenceExtendedAway5Signifies that the contact is away for an extended period of time
QContactPresence::PresenceOffline6Signifies that the contact is offline


Member Function Documentation

QString QContactPresence::customMessage () const

Returns the custom status message from the contact for the online account about which this detail stores presence information.

See also setCustomMessage().

QString QContactPresence::nickname () const

Returns the last-known nickname used by the contact during communications via the online account.

See also setNickname().

PresenceState QContactPresence::presenceState () const

Returns the presence state of the online account according to the presence provider.

See also setPresenceState().

QUrl QContactPresence::presenceStateImageUrl () const

Returns the last-known status image url of the contact for the online account about which this detail stores presence information.

See also setPresenceStateImageUrl().

QString QContactPresence::presenceStateText () const

Returns the text corresponding to the current presence state.

See also setPresenceStateText().

void QContactPresence::setCustomMessage ( const QString & customMessage )

Sets the custom status message from the contact for the online account about which this detail stores presence information, to customMessage. This custom message would have been set by the contact, and does not necessarily correspond to a particular presence state.

See also customMessage().

void QContactPresence::setNickname ( const QString & nickname )

Sets the last-known nickname used by the contact during communications via the online account about which this detail stores presence information to nickname.

See also nickname().

void QContactPresence::setPresenceState ( PresenceState presenceState )

Sets the presence state of the online account according to the presence information provider to the given presenceState.

See also presenceState().

void QContactPresence::setPresenceStateImageUrl ( const QUrl & presenceStateImageUrl )

Sets the last-known status image url of the contact for the online account about which this detail stores presence information, to presenceStateImageUrl.

See also presenceStateImageUrl().

void QContactPresence::setPresenceStateText ( const QString & presenceStateText )

Sets the text corresponding to the presence state to presenceStateText. This function is generally called by presence providers to allow custom naming of states, or to allow finer grained state reporting than is provided by the presence state API.

See also presenceStateText().

void QContactPresence::setTimestamp ( const QDateTime & updateTimestamp )

Sets the timestamp for the last update of the presence detail to be updateTimestamp.

See also timestamp().

QDateTime QContactPresence::timestamp () const

Returns the timestamp at which the data in the presence detail was valid.

See also setTimestamp().


Member Variable Documentation

const QLatin1Constant QContactPresence::DefinitionName

The string constant for the definition name of QContactPresence details.

const QLatin1Constant QContactPresence::FieldCustomMessage

The field key constant for the user-entered custom presence message.

See also setCustomMessage() and customMessage().

const QLatin1Constant QContactPresence::FieldNickname

The field key constant for the nickname value.

See also setNickname() and nickname().

const QLatin1Constant QContactPresence::FieldPresenceState

The field key constant for the presence state enumeration value.

See also setPresenceState() and presenceState().

const QLatin1Constant QContactPresence::FieldPresenceStateImageUrl

The field key constant for the presence state image URL.

See also setPresenceStateImageUrl() and presenceStateImageUrl().

const QLatin1Constant QContactPresence::FieldPresenceStateText

The field key constant for the presence state description value.

See also setPresenceStateText() and presenceStateText().

const QLatin1Constant QContactPresence::FieldTimestamp

The field key constant for the timestamp value.

See also setTimestamp() and timestamp().


Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.1