MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QContactAvatar Class Reference

The QContactAvatar class contains avatar URLs of a contact. More...

 #include <QContactAvatar>

Inherits: QContactDetail.

This class was introduced in Qt Mobility 1.0.

Public Functions

QUrl imageUrl () const
void setImageUrl ( const QUrl & imageUrl )
void setVideoUrl ( const QUrl & videoUrl )
QUrl videoUrl () const

Static Public Members

const QLatin1Constant DefinitionName
const QLatin1Constant FieldImageUrl
const QLatin1Constant FieldVideoUrl

Detailed Description

The QContactAvatar class contains avatar URLs of a contact.

Users can specify avatar URLs for a contact using this detail. Generally, a URL will specify the location of a full-sized image (or video) avatar. Support for the detail is backend-specific; some managers will automatically load the URL and synthesize a (possibly scaled) thumbnail detail for the contact if no thumbnail was explicitly set, while others will not.

The URLs which are contained in the detail may point to a file or resource whose content may dynamically change. This is in contrast to the thumbnail detail which is static; once set it remains as that image until set to something else. That is, the content of a QContactThumbnail detail is set by the user who has created the contact, but the content of a resource identified by a URL specified in a QContactAvatar detail is set by whoever owns the resource which the URL identifies.

This leaf-class has been part of the default schema since version 1.0 of the Qt Mobility project.

See also QContactThumbnail.

Member Function Documentation

QUrl QContactAvatar::imageUrl () const

Returns the url of an avatar image associated with the contact

This function was introduced in Qt Mobility 1.0.

See also setImageUrl().

void QContactAvatar::setImageUrl ( const QUrl & imageUrl )

Sets the url of an avatar image associated with the contact to imageUrl

This function was introduced in Qt Mobility 1.0.

See also imageUrl().

void QContactAvatar::setVideoUrl ( const QUrl & videoUrl )

Sets the url of an avatar video associated with the contact to videoUrl

This function was introduced in Qt Mobility 1.0.

See also videoUrl().

QUrl QContactAvatar::videoUrl () const

Returns the url of an avatar video associated with the contact

This function was introduced in Qt Mobility 1.0.

See also setVideoUrl().

Member Variable Documentation

const QLatin1Constant QContactAvatar::DefinitionName

The string constant for the definition name of QContactAvatar details.

const QLatin1Constant QContactAvatar::FieldImageUrl

The field key constant for the value containing the URL of the avatar image.

See also imageUrl() and setImageUrl().

const QLatin1Constant QContactAvatar::FieldVideoUrl

The field key constant for the value containing the URL of a video avatar.

See also videoUrl() and setVideoUrl().