<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qdeclarativecontactdetail.cpp --> <title>Qt Mobility 1.2: QML Presence Element</title> <link rel="stylesheet" type="text/css" href="style/offline.css" /> </head> <body> <div class="header" id="qtdocheader"> <div class="content"> <a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a> </div> <div class="breadcrumb toolblock"> <ul> <li class="first"><a href="index.html">Home</a></li> <!-- Breadcrumbs go here --> <li><a href="http://qt.nokia.com/doc/4.7/qdeclarativeelements.html">QML Elements</a></li> <li>QML Presence Element</li> </ul> </div> </div> <div class="content mainContent"> <div class="toc"> <h3><a name="toc">Contents</a></h3> <ul> <li class="level1"><a href="#properties">Properties</a></li> <li class="level1"><a href="#details">Detailed Description</a></li> </ul> </div> <h1 class="title">QML Presence Element</h1> <span class="subtitle"></span> <!-- $$$Presence-brief --> <p>The Presence element provides presence information for an online account of a contact. <a href="#details">More...</a></p> <!-- @@@Presence --> <p>This element was introduced in Mobility 1.1.</p> <ul> <li><a href="qml-presence-members.html">List of all members, including inherited members</a></li> </ul> <a name="properties"></a> <h2>Properties</h2> <ul> <li class="fn"><b><b><a href="qml-presence.html#customMessage-prop">customMessage</a></b></b> : string</li> <li class="fn"><b><b><a href="qml-presence.html#imageUrl-prop">imageUrl</a></b></b> : url</li> <li class="fn"><b><b><a href="qml-presence.html#nickname-prop">nickname</a></b></b> : string</li> <li class="fn"><b><b><a href="qml-presence.html#state-prop">state</a></b></b> : enumeration</li> <li class="fn"><b><b><a href="qml-presence.html#stateText-prop">stateText</a></b></b> : string</li> <li class="fn"><b><b><a href="qml-presence.html#timestamp-prop">timestamp</a></b></b> : date</li> </ul> <!-- $$$Presence-description --> <a name="details"></a> <h2>Detailed Description</h2> <p>Presence element contains the following field types:</p> <ul> <li>Presence.Timestamp</li> <li>Presence.Nickname</li> <li>Presence.State</li> <li>Presence.StateText</li> <li>Presence.ImageUrl</li> <li>Presence.CustomMessage</li> </ul> <p>This element is part of the <b>QtMobility.contacts 1.1</b> module.</p> <!-- @@@Presence --> <h2>Property Documentation</h2> <!-- $$$customMessage --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="customMessage-prop"></a><span class="name">customMessage</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the custom status message from the contact for the online account about which this detail stores presence information.</p> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@customMessage --> <br/> <!-- $$$imageUrl --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="imageUrl-prop"></a><span class="name">imageUrl</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-url.html">url</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the last-known status image url of the contact for the online account about which this detail stores presence information.</p> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@imageUrl --> <br/> <!-- $$$nickname --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="nickname-prop"></a><span class="name">nickname</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the nickname value of the Presence.</p> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@nickname --> <br/> <!-- $$$state --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="state-prop"></a><span class="name">state</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the presence state enumeration value.</p> <ul> <li>Presence.Unknown - Signifies that the presence state of the contact is not currently known (default).</li> <li>Presence.Available - Signifies that the contact is available.</li> <li>Presence.Hidden - Signifies that the contact is hidden.</li> <li>Presence.Busy - Signifies that the contact is busy.</li> <li>Presence.Away - Signifies that the contact is away.</li> <li>Presence.ExtendedAway - Signifies that the contact is away for an extended period of time.</li> <li>Presence.Offline - Signifies that the contact is offline.</li> </ul> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@state --> <br/> <!-- $$$stateText --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="stateText-prop"></a><span class="name">stateText</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the text corresponding to the current presence state.</p> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@stateText --> <br/> <!-- $$$timestamp --> <div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="timestamp-prop"></a><span class="name">timestamp</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-date.html">date</a></span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the timestamp value of the Presence.</p> <p>This property group was introduced in Mobility 1.1.</p> </div></div><!-- @@@timestamp --> <br/> <div class="ft"> <span></span> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.</p> <p> All other trademarks are property of their respective owners. <a title="Privacy Policy" href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p> <br /> <p> Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.</p> <p> Alternatively, this document may be used under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.</p> </div> </body> </html>