Sophie: qt-mobility-doc-1.2.0-13.mga5 noarch

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?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" />
  <title>Qt Mobility 1.2: contacteditor.cpp Example File (samplephonebook/contacteditor.cpp)</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 -->
    </ul>
  </div>
</div>
<div class="content mainContent">
<h1 class="title">contacteditor.cpp Example File</h1>
<span class="small-subtitle">samplephonebook/contacteditor.cpp</span>
<!-- $$$samplephonebook/contacteditor.cpp-description -->
<div class="descr"> <a name="details"></a>
<pre class="cpp"> <span class="comment">/****************************************************************************
 **
 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
 ** This file is part of the examples of the Qt Mobility Components.
 **
 ** $QT_BEGIN_LICENSE:BSD$
 ** You may use this file under the terms of the BSD license as follows:
 **
 ** &quot;Redistribution and use in source and binary forms, with or without
 ** modification, are permitted provided that the following conditions are
 ** met:
 **   * Redistributions of source code must retain the above copyright
 **     notice, this list of conditions and the following disclaimer.
 **   * Redistributions in binary form must reproduce the above copyright
 **     notice, this list of conditions and the following disclaimer in
 **     the documentation and/or other materials provided with the
 **     distribution.
 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
 **     the names of its contributors may be used to endorse or promote
 **     products derived from this software without specific prior written
 **     permission.
 **
 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 ** &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.&quot;
 ** $QT_END_LICENSE$
 **
 ****************************************************************************/</span>

 <span class="preprocessor">#include &quot;contacteditor.h&quot;</span>

 <span class="preprocessor">#include &lt;QtGui&gt;</span>
 <span class="preprocessor">#include &lt;QDesktopServices&gt;</span>

 <span class="keyword">const</span> <span class="type">int</span> MAX_THUMBNAIL_DISPLAY_SIZE <span class="operator">=</span> <span class="number">120</span>;

 ContactEditor<span class="operator">::</span>ContactEditor(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a></span> <span class="operator">*</span>parent)
         :<span class="type"><a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a></span>(parent)
 {
     m_manager <span class="operator">=</span> <span class="number">0</span>;
     m_contactId <span class="operator">=</span> <span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span>(<span class="number">0</span>);
     m_observer <span class="operator">=</span> <span class="number">0</span>;

     m_nameEdit <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlineedit.html">QLineEdit</a></span>(<span class="keyword">this</span>);
     m_phoneEdit <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlineedit.html">QLineEdit</a></span>(<span class="keyword">this</span>);
     m_emailEdit <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlineedit.html">QLineEdit</a></span>(<span class="keyword">this</span>);
     m_addrEdit <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlineedit.html">QLineEdit</a></span>(<span class="keyword">this</span>);
     m_thumbnailBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;Set picture&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     m_clearThumbnailBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;Clear&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     m_thumbnailView <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(<span class="keyword">this</span>);
     connect(m_thumbnailBtn<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(thumbnailClicked()));
     connect(m_clearThumbnailBtn<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(clearThumbnailClicked()));

     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qformlayout.html">QFormLayout</a></span> <span class="operator">*</span>detailsLayout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qformlayout.html">QFormLayout</a></span>;
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span> <span class="operator">*</span>nameLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;Name&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span> <span class="operator">*</span>phoneLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;Phone&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span> <span class="operator">*</span>emailLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;Email&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span> <span class="operator">*</span>addressLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;Address&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span> <span class="operator">*</span>thumbnailLabel <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlabel.html">QLabel</a></span>(tr(<span class="string">&quot;Picture&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qhboxlayout.html">QHBoxLayout</a></span> <span class="operator">*</span>thumbnailBtnLayout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qhboxlayout.html">QHBoxLayout</a></span>;
     thumbnailBtnLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(m_thumbnailBtn);
     thumbnailBtnLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(m_clearThumbnailBtn);
     <span class="keyword">if</span> (<span class="type"><a href="http://qt.nokia.com/doc/4.7/qapplication.html">QApplication</a></span><span class="operator">::</span>desktop()<span class="operator">-</span><span class="operator">&gt;</span>availableGeometry()<span class="operator">.</span>width() <span class="operator">&lt;</span> <span class="number">360</span>) {
         <span class="comment">// Narrow screen: put label on separate line to textbox</span>
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(nameLabel);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(m_nameEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(phoneLabel);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(m_phoneEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(emailLabel);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(m_emailEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(addressLabel);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(m_addrEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(thumbnailLabel);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(thumbnailBtnLayout);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(m_thumbnailView);
     } <span class="keyword">else</span> {
         <span class="comment">// Wide screen: put label on same line as textbox</span>
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(nameLabel<span class="operator">,</span> m_nameEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(phoneLabel<span class="operator">,</span> m_phoneEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(emailLabel<span class="operator">,</span> m_emailEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(addressLabel<span class="operator">,</span> m_addrEdit);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(thumbnailLabel<span class="operator">,</span> thumbnailBtnLayout);
         detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>addRow(<span class="string">&quot;&quot;</span><span class="operator">,</span> m_thumbnailView);
     }
     detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>setFieldGrowthPolicy(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qformlayout.html">QFormLayout</a></span><span class="operator">::</span>ExpandingFieldsGrow);
     detailsLayout<span class="operator">-</span><span class="operator">&gt;</span>setSizeConstraint(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qlayout.html">QLayout</a></span><span class="operator">::</span>SetMinAndMaxSize);

     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qscrollarea.html">QScrollArea</a></span> <span class="operator">*</span>detailsScrollArea <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qscrollarea.html">QScrollArea</a></span>(<span class="keyword">this</span>);
     detailsScrollArea<span class="operator">-</span><span class="operator">&gt;</span>setWidgetResizable(<span class="keyword">true</span>);
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a></span> <span class="operator">*</span>detailsContainer <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a></span>(detailsScrollArea);
     detailsContainer<span class="operator">-</span><span class="operator">&gt;</span>setLayout(detailsLayout);
     detailsScrollArea<span class="operator">-</span><span class="operator">&gt;</span>setWidget(detailsContainer);

     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qvboxlayout.html">QVBoxLayout</a></span> <span class="operator">*</span>editLayout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qvboxlayout.html">QVBoxLayout</a></span>;
     editLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(detailsScrollArea);

 <span class="preprocessor">#ifdef Q_OS_SYMBIAN</span>
     <span class="comment">// In symbian &quot;save&quot; and &quot;cancel&quot; buttons are softkeys.</span>
     m_saveBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qaction.html">QAction</a></span>(tr(<span class="string">&quot;Save&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     m_saveBtn<span class="operator">-</span><span class="operator">&gt;</span>setSoftKeyRole(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qaction.html">QAction</a></span><span class="operator">::</span>PositiveSoftKey);
     addAction(m_saveBtn);
     connect(m_saveBtn<span class="operator">,</span> SIGNAL(triggered(<span class="type">bool</span>))<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(saveClicked()));
     m_cancelBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qaction.html">QAction</a></span>(tr(<span class="string">&quot;Cancel&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     m_cancelBtn<span class="operator">-</span><span class="operator">&gt;</span>setSoftKeyRole(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qaction.html">QAction</a></span><span class="operator">::</span>NegativeSoftKey);
     addAction(m_cancelBtn);
     connect(m_cancelBtn<span class="operator">,</span> SIGNAL(triggered(<span class="type">bool</span>))<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(cancelClicked()));
 <span class="preprocessor">#else</span>
     m_saveBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;&amp;Save&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     m_saveBtn<span class="operator">-</span><span class="operator">&gt;</span>setDefault(<span class="keyword">true</span>);
     connect(m_saveBtn<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(saveClicked()));
     m_cancelBtn <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpushbutton.html">QPushButton</a></span>(tr(<span class="string">&quot;&amp;Cancel&quot;</span>)<span class="operator">,</span> <span class="keyword">this</span>);
     connect(m_cancelBtn<span class="operator">,</span> SIGNAL(clicked())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(cancelClicked()));
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qhboxlayout.html">QHBoxLayout</a></span> <span class="operator">*</span>btnLayout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qhboxlayout.html">QHBoxLayout</a></span>;
     btnLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(m_saveBtn);
     btnLayout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(m_cancelBtn);
     editLayout<span class="operator">-</span><span class="operator">&gt;</span>addLayout(btnLayout);
 <span class="preprocessor">#endif</span>

     setLayout(editLayout);
 }

 ContactEditor<span class="operator">::</span><span class="operator">~</span>ContactEditor()
 {
     <span class="keyword">delete</span> m_observer;
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>setCurrentContact(<span class="type"><a href="qcontactmanager.html">QContactManager</a></span><span class="operator">*</span> manager<span class="operator">,</span> <span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span> currentId)
 {
     m_manager <span class="operator">=</span> manager;
     m_contactId <span class="operator">=</span> currentId;
     m_newThumbnailPath <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>();

     <span class="comment">// Clear UI</span>
     m_nameEdit<span class="operator">-</span><span class="operator">&gt;</span>clear();
     m_phoneEdit<span class="operator">-</span><span class="operator">&gt;</span>clear();
     m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>clear();
     m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>clear();

     <span class="keyword">if</span> (manager <span class="operator">=</span><span class="operator">=</span> <span class="number">0</span>) {
         m_saveBtn<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">false</span>);
         <span class="keyword">return</span>;
     }

     <span class="comment">// enable the UI.</span>
     m_saveBtn<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">true</span>);

     <span class="comment">// otherwise, build from the contact details.</span>
     <span class="type"><a href="qcontact.html">QContact</a></span> contact;
     <span class="keyword">if</span> (m_contactId <span class="operator">!</span><span class="operator">=</span> <span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span>(<span class="number">0</span>))
         contact <span class="operator">=</span> manager<span class="operator">-</span><span class="operator">&gt;</span>contact(m_contactId);

     <span class="comment">// Set an observer on the contact to watch it for changes from another process</span>
     <span class="keyword">delete</span> m_observer;
     m_observer <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcontactobserver.html">QContactObserver</a></span>(manager<span class="operator">,</span> m_contactId);
     connect(m_observer<span class="operator">,</span> SIGNAL(contactChanged())<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(contactChanged()));

     updateUi(contact);
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>updateUi(<span class="keyword">const</span> <span class="type"><a href="qcontact.html">QContact</a></span><span class="operator">&amp;</span> contact)
 {
     <span class="comment">// Disable fields &amp; buttons according to what the backend supports</span>
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><span class="operator">&lt;</span><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span><span class="operator">,</span> <span class="type"><a href="qcontactdetaildefinition.html">QContactDetailDefinition</a></span><span class="operator">&gt;</span> defs <span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>detailDefinitions(<span class="type"><a href="qcontacttype.html">QContactType</a></span><span class="operator">::</span>TypeContact);

     <span class="comment">// name</span>
     <span class="keyword">if</span> (m_contactId <span class="operator">!</span><span class="operator">=</span> <span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span>(<span class="number">0</span>))
         m_nameEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(contact<span class="operator">.</span>displayLabel());

     <span class="comment">// phonenumber</span>
     <span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span> phn <span class="operator">=</span> contact<span class="operator">.</span>detail(<span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">::</span>DefinitionName);
     m_phoneEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(phn<span class="operator">.</span>value(<span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">::</span>FieldNumber));

     <span class="comment">// email</span>
     <span class="keyword">if</span> (defs<span class="operator">.</span>contains(<span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span><span class="operator">::</span>DefinitionName)) {
         <span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span> em <span class="operator">=</span> contact<span class="operator">.</span>detail(<span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span><span class="operator">::</span>DefinitionName);
         m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(em<span class="operator">.</span>value(<span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span><span class="operator">::</span>FieldEmailAddress));
         m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>setReadOnly(<span class="keyword">false</span>);
     } <span class="keyword">else</span> {
         m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(<span class="string">&quot;&lt;not supported&gt;&quot;</span>);
         m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>setReadOnly(<span class="keyword">true</span>);
     }

     <span class="comment">// address</span>
     <span class="keyword">if</span> (defs<span class="operator">.</span>contains(<span class="type"><a href="qcontactaddress.html">QContactAddress</a></span><span class="operator">::</span>DefinitionName)) {
         <span class="type"><a href="qcontactaddress.html">QContactAddress</a></span> adr <span class="operator">=</span> contact<span class="operator">.</span>detail(<span class="type"><a href="qcontactaddress.html">QContactAddress</a></span><span class="operator">::</span>DefinitionName);
         m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(adr<span class="operator">.</span>value(<span class="type"><a href="qcontactaddress.html">QContactAddress</a></span><span class="operator">::</span>FieldStreet)); <span class="comment">// ugly hack.</span>
         m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>setReadOnly(<span class="keyword">false</span>);
     } <span class="keyword">else</span> {
         m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>setText(<span class="string">&quot;&lt;not supported&gt;&quot;</span>);
         m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>setReadOnly(<span class="keyword">true</span>);
     }

     <span class="comment">// thumbnail viewer</span>
     <span class="keyword">if</span> (defs<span class="operator">.</span>contains(<span class="type"><a href="qcontactthumbnail.html">QContactThumbnail</a></span><span class="operator">::</span>DefinitionName)) {
         m_thumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">true</span>);
         <span class="type"><a href="qcontactthumbnail.html">QContactThumbnail</a></span> thumb <span class="operator">=</span> contact<span class="operator">.</span>detail(<span class="type"><a href="qcontactthumbnail.html">QContactThumbnail</a></span><span class="operator">::</span>DefinitionName);
         m_thumbnailView<span class="operator">-</span><span class="operator">&gt;</span>clear();
         m_thumbnail <span class="operator">=</span> thumb<span class="operator">.</span>thumbnail();
         <span class="keyword">if</span> (m_thumbnail<span class="operator">.</span>isNull()) {
             m_thumbnailView<span class="operator">-</span><span class="operator">&gt;</span>clear();
             m_clearThumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setDisabled(<span class="keyword">true</span>);
         } <span class="keyword">else</span> {
             setThumbnailPixmap(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qpixmap.html">QPixmap</a></span><span class="operator">::</span>fromImage(m_thumbnail));
         }
     } <span class="keyword">else</span> {
         m_thumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setDisabled(<span class="keyword">true</span>);
         m_clearThumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setDisabled(<span class="keyword">true</span>);
     }
 }

 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> ContactEditor<span class="operator">::</span>nameField()
 {
     <span class="comment">// return the field which the name data should be saved in.</span>
     <span class="keyword">if</span> (<span class="operator">!</span>m_manager)
         <span class="keyword">return</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>();

     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><span class="operator">&lt;</span><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span><span class="operator">,</span> <span class="type"><a href="qcontactdetaildefinition.html">QContactDetailDefinition</a></span><span class="operator">&gt;</span> defs <span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>detailDefinitions(<span class="type"><a href="qcontacttype.html">QContactType</a></span><span class="operator">::</span>TypeContact);
     <span class="type"><a href="qcontactdetaildefinition.html">QContactDetailDefinition</a></span> nameDef <span class="operator">=</span> defs<span class="operator">.</span>value(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>DefinitionName);
     <span class="keyword">if</span> (nameDef<span class="operator">.</span>fields()<span class="operator">.</span>keys()<span class="operator">.</span>contains(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>FieldCustomLabel)) {
         <span class="keyword">return</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>(QLatin1String(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>FieldCustomLabel));
     } <span class="keyword">else</span> <span class="keyword">if</span> (nameDef<span class="operator">.</span>fields()<span class="operator">.</span>keys()<span class="operator">.</span>contains(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>FieldFirstName)) {
         <span class="keyword">return</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>(QLatin1String(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>FieldFirstName));
     } <span class="keyword">else</span> {
         <span class="keyword">return</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>();
     }
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>setThumbnailPixmap(<span class="keyword">const</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpixmap.html">QPixmap</a></span> <span class="operator">&amp;</span>pixmap)
 {
     <span class="keyword">if</span> (pixmap<span class="operator">.</span>isNull())
         <span class="keyword">return</span>;
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qpixmap.html">QPixmap</a></span> scaled <span class="operator">=</span> pixmap<span class="operator">.</span>scaled(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qsize.html">QSize</a></span>(MAX_THUMBNAIL_DISPLAY_SIZE<span class="operator">,</span> MAX_THUMBNAIL_DISPLAY_SIZE)<span class="operator">,</span>
                                    <span class="type"><a href="http://qt.nokia.com/doc/4.7/qt.html">Qt</a></span><span class="operator">::</span>KeepAspectRatio<span class="operator">,</span>
                                    <span class="type"><a href="http://qt.nokia.com/doc/4.7/qt.html">Qt</a></span><span class="operator">::</span>SmoothTransformation);
     m_thumbnailView<span class="operator">-</span><span class="operator">&gt;</span>setPixmap(scaled);
     m_thumbnailView<span class="operator">-</span><span class="operator">&gt;</span>setMaximumSize(scaled<span class="operator">.</span>size());
     m_clearThumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setEnabled(<span class="keyword">true</span>);
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>clearThumbnailClicked()
 {
     m_thumbnailView<span class="operator">-</span><span class="operator">&gt;</span>clear();
     m_thumbnail <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qimage.html">QImage</a></span>();
     m_newThumbnailPath<span class="operator">.</span>clear();
     m_clearThumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>setDisabled(<span class="keyword">true</span>);
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>thumbnailClicked()
 {
     <span class="comment">// put up a file dialog, and update the new thumbnail path.</span>
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> docPath <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdesktopservices.html">QDesktopServices</a></span><span class="operator">::</span>storageLocation(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qdesktopservices.html">QDesktopServices</a></span><span class="operator">::</span>DocumentsLocation);
     <span class="keyword">if</span> (docPath<span class="operator">.</span>isEmpty())
         docPath <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdesktopservices.html">QDesktopServices</a></span><span class="operator">::</span>storageLocation(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qdesktopservices.html">QDesktopServices</a></span><span class="operator">::</span>HomeLocation);
     <span class="keyword">if</span> (docPath<span class="operator">.</span>isEmpty())
         docPath <span class="operator">=</span> <span class="string">&quot;.&quot;</span>;
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> fileName <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qfiledialog.html">QFileDialog</a></span><span class="operator">::</span>getOpenFileName(<span class="keyword">this</span><span class="operator">,</span>
        tr(<span class="string">&quot;Select Contact Picture&quot;</span>)<span class="operator">,</span> docPath<span class="operator">,</span> tr(<span class="string">&quot;Image Files (*.png *.jpg *.bmp)&quot;</span>));

     <span class="keyword">if</span> (<span class="operator">!</span>fileName<span class="operator">.</span>isEmpty()) {
         m_newThumbnailPath <span class="operator">=</span> fileName;
         m_thumbnail <span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qimage.html">QImage</a></span>(m_newThumbnailPath);
         setThumbnailPixmap(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qpixmap.html">QPixmap</a></span><span class="operator">::</span>fromImage(m_thumbnail));
     }
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>saveClicked()
 {
     <span class="comment">// Stop observing the contact</span>
     <span class="keyword">if</span> (m_observer) {
         m_observer<span class="operator">-</span><span class="operator">&gt;</span>disconnect();
     }

     <span class="keyword">if</span> (<span class="operator">!</span>m_manager) {
         <a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qWarning">qWarning</a>() <span class="operator">&lt;</span><span class="operator">&lt;</span> <span class="string">&quot;No manager selected; cannot save.&quot;</span>;
     } <span class="keyword">else</span> {
         <span class="type"><a href="qcontact.html">QContact</a></span> curr;
         <span class="keyword">if</span> (m_contactId <span class="operator">!</span><span class="operator">=</span> <span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span>(<span class="number">0</span>))
             curr <span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>contact(m_contactId);

         <span class="keyword">if</span> (m_nameEdit<span class="operator">-</span><span class="operator">&gt;</span>text()<span class="operator">.</span>isEmpty()) {
             <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> <span class="string">&quot;Failed!&quot;</span><span class="operator">,</span> <span class="string">&quot;You must give a name for the contact!&quot;</span>);
             <span class="keyword">return</span>;
         }

         <span class="keyword">if</span> (m_nameEdit<span class="operator">-</span><span class="operator">&gt;</span>text() <span class="operator">!</span><span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>synthesizedContactDisplayLabel(curr)) {
             <span class="comment">// if the name has changed (ie, is different to the synthed label) then save it as a custom label.</span>
             <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> saveNameField <span class="operator">=</span> nameField();
             <span class="keyword">if</span> (<span class="operator">!</span>saveNameField<span class="operator">.</span>isEmpty()) {
                 <span class="type"><a href="qcontactname.html">QContactName</a></span> nm <span class="operator">=</span> curr<span class="operator">.</span>detail(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>DefinitionName);
                 nm<span class="operator">.</span>setValue(saveNameField<span class="operator">,</span> m_nameEdit<span class="operator">-</span><span class="operator">&gt;</span>text());
                 curr<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>nm);
             }
         }

         <span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span> phn <span class="operator">=</span> curr<span class="operator">.</span>detail(<span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">::</span>DefinitionName);
         phn<span class="operator">.</span>setNumber(m_phoneEdit<span class="operator">-</span><span class="operator">&gt;</span>text());
         curr<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>phn);

         <span class="keyword">if</span> (<span class="operator">!</span>m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>isReadOnly()) {
             <span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span> em <span class="operator">=</span> curr<span class="operator">.</span>detail(<span class="type"><a href="qcontactemailaddress.html">QContactEmailAddress</a></span><span class="operator">::</span>DefinitionName);
             em<span class="operator">.</span>setEmailAddress(m_emailEdit<span class="operator">-</span><span class="operator">&gt;</span>text());
             curr<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>em);
         }

         <span class="keyword">if</span> (<span class="operator">!</span>m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>isReadOnly()) {
             <span class="type"><a href="qcontactaddress.html">QContactAddress</a></span> adr <span class="operator">=</span> curr<span class="operator">.</span>detail(<span class="type"><a href="qcontactaddress.html">QContactAddress</a></span><span class="operator">::</span>DefinitionName);
             adr<span class="operator">.</span>setStreet(m_addrEdit<span class="operator">-</span><span class="operator">&gt;</span>text());
             curr<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>adr);
         }

         <span class="keyword">if</span> (m_thumbnailBtn<span class="operator">-</span><span class="operator">&gt;</span>isEnabled()) {
             <span class="type"><a href="qcontactthumbnail.html">QContactThumbnail</a></span> thumb <span class="operator">=</span> curr<span class="operator">.</span>detail(<span class="type"><a href="qcontactthumbnail.html">QContactThumbnail</a></span><span class="operator">::</span>DefinitionName);
             <span class="type"><a href="http://qt.nokia.com/doc/4.7/qimage.html">QImage</a></span> img(m_thumbnail);
             thumb<span class="operator">.</span>setThumbnail(img);
             curr<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>thumb);
         }

         curr <span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>compatibleContact(curr);
         <span class="type">bool</span> success <span class="operator">=</span> m_manager<span class="operator">-</span><span class="operator">&gt;</span>saveContact(<span class="operator">&amp;</span>curr);
         <span class="keyword">if</span> (<span class="operator">!</span>success)
             <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>information(<span class="keyword">this</span><span class="operator">,</span> <span class="string">&quot;Failed!&quot;</span><span class="operator">,</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>(<span class="string">&quot;Failed to save contact!\n(error code %1)&quot;</span>)<span class="operator">.</span>arg(m_manager<span class="operator">-</span><span class="operator">&gt;</span>error()));
     }

     <span class="keyword">emit</span> showListPage();
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>cancelClicked()
 {
     <span class="keyword">emit</span> showListPage();
 }

 <span class="type">void</span> ContactEditor<span class="operator">::</span>contactChanged()
 {
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>StandardButton button <span class="operator">=</span>
         <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>question(<span class="keyword">this</span><span class="operator">,</span> <span class="string">&quot;Contact updated&quot;</span><span class="operator">,</span>
                 <span class="string">&quot;The contact has been changed by some other process.\n\nDo you want to reload it?&quot;</span><span class="operator">,</span>
                 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>Yes <span class="operator">|</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>No);
     <span class="keyword">if</span> (button <span class="operator">=</span><span class="operator">=</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmessagebox.html">QMessageBox</a></span><span class="operator">::</span>Yes) {
         updateUi(m_manager<span class="operator">-</span><span class="operator">&gt;</span>contact(m_contactId));
     }
 }</pre>
</div>
<!-- @@@samplephonebook/contacteditor.cpp -->
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</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>