<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>kpilot/lib: PilotAddress Class Reference (kpilot/lib)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
<style type="text/css">
<!--
hr { display: none; }
#content h2 { margin-left: 0px; }
table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; }
td.mdRow { padding: 8px 20px; }
td.md { font-weight: bold; }
td.mdname1 { font-weight: bold; color: #602020; }
td.mdname { font-weight: bold; color: #602020; }
-->
</style>
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<img id="nav_header_logo_right" alt="" align="right" src="../../../pimlogo.png" border="0" />
<div id="nav_header_title" align="left">KDE PIM API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_left" style="text-align: left;">
/ <a href="../../../">API Reference</a>
/ <a href="../../html/index.html">kpilot</a> / <a href=".">lib</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<h2><a name="content"></a>kpilot/lib</h2>
<!-- Generated by Doxygen 1.5.5 -->
<div class="contents">
<h1>PilotAddress Class Reference</h1><!-- doxytag: class="PilotAddress" --><!-- doxytag: inherits="PilotRecordBase" --><code>#include <<a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a>></code>
<p>
<div class="dynheader">
Inheritance diagram for PilotAddress:</div>
<div class="dynsection">
<p><center><img src="classPilotAddress.png" usemap="#PilotAddress_map" border="0" alt=""></center>
<map name="PilotAddress_map">
<area href="classPilotRecordBase.html" alt="PilotRecordBase" shape="rect" coords="0,0,105,24">
</map>
</div>
<p>
<a href="classPilotAddress-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
A wrapper class around the Address struct provided by pi-address.h.
<p>
This class allows the user to set and get address field values. For everything but phone fields, the user can simply pass the the pi-address enum for the index for <a class="el" href="classPilotAddress.html#b9ce46f8467e1398e07add21331cb002">setField()</a> and <a class="el" href="classPilotAddress.html#d3a5d11c6e70919518fb6e2dade797c5" title="Returns the text value of a given field field (or QString::null if there is no such...">getField()</a> such as entryLastname.<p>
Phone fields are a bit trickier. The structure allows for 8 possible phone fields with 5 possible slots. That means there could be three fields that don't have available storage. The <a class="el" href="classPilotAddress.html#44d941a6e25e177871ae25b75299cd0a">setPhoneField()</a> method will attempt to store the extra fields in a custom field if there is an overflow.<p>
There are eight possible fields for 5 view slots:<ul>
<li>fields: Work, Home, Fax, Other, Pager, Mobile, E-mail, Main</li><li>slots: entryPhone1, entryPhone2, entryPhone3, entryPhone4, entryPhone5</li></ul>
<p>
Internally in the pilot-link library, the AddressAppInfo phone array stores the strings for the eight possible phone values. Their English string values are :<ul>
<li>phone[0] = Work</li><li>phone[1] = Home</li><li>phone[2] = Fax</li><li>phone[3] = Other</li><li>phone[4] = E-mail</li><li>phone[5] = Main</li><li>phone[6] = Pager</li><li>phone[7] = Mobile</li></ul>
<p>
Apparently, this order is kept for all languages, just with localized strings. The implementation of the internal methods will assume this order is kept. In other languages, main can replaced with Corporation.
<p>Definition at line <a class="el" href="pilotAddress_8h-source.html#l00190">190</a> of file <a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a>.</p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f993847">PhoneHandlingFlags</a> { <a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f9938475bb8b2f53737e57ccf4768b3cf3265f6">NoFlags</a> = 0,
<a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f993847418404a8caea058eda1c25b5b46e8a74">Replace</a>
}</td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a660becd2d456750bbc76610d81ca5da"></a><!-- doxytag: member="PilotAddress::PilotAddress" ref="a660becd2d456750bbc76610d81ca5da" args="(PilotRecord *rec=0L)" -->
</td><td class="memItemRight" valign="bottom"><b>PilotAddress</b> (<a class="el" href="classPilotRecord.html">PilotRecord</a> *rec=0L)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="36f764347871c0ea0c620c4f7118e49d"></a><!-- doxytag: member="PilotAddress::PilotAddress" ref="36f764347871c0ea0c620c4f7118e49d" args="(const PilotAddress &copyFrom)" -->
</td><td class="memItemRight" valign="bottom"><b>PilotAddress</b> (const <a class="el" href="classPilotAddress.html">PilotAddress</a> &copyFrom)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b907fb8cd3c588c38e89f87ad824396c"></a><!-- doxytag: member="PilotAddress::operator=" ref="b907fb8cd3c588c38e89f87ad824396c" args="(const PilotAddress &r)" -->
<a class="el" href="classPilotAddress.html">PilotAddress</a> & </td><td class="memItemRight" valign="bottom"><b>operator=</b> (const <a class="el" href="classPilotAddress.html">PilotAddress</a> &r)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="5de9035345d939aeb8ddc856601a560c"></a><!-- doxytag: member="PilotAddress::operator==" ref="5de9035345d939aeb8ddc856601a560c" args="(const PilotAddress &r)" -->
bool </td><td class="memItemRight" valign="bottom"><b>operator==</b> (const <a class="el" href="classPilotAddress.html">PilotAddress</a> &r)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#3e541f0c6f914f818678cad8ba5d27eb">getTextRepresentation</a> (const PilotAddressInfo *info, Qt::TextFormat richText) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#b9ce46f8467e1398e07add21331cb002">setField</a> (int field, const QString &text)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#f13f9e237daa8a1b51a2aff48beca72d">setField</a> (const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> &i, const QString &t)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#d3a5d11c6e70919518fb6e2dade797c5">getField</a> (int field) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#bdbcb9743f64b56181951bc1d7eb4c8e">getField</a> (const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> &i) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#30f0c10eb8099bc537026dd8c1570fb4">getEmails</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="97d2d4895ac85c7c828ae4057460db05"></a><!-- doxytag: member="PilotAddress::setEmails" ref="97d2d4895ac85c7c828ae4057460db05" args="(const QStringList &emails)" -->
void </td><td class="memItemRight" valign="bottom"><b>setEmails</b> (const QStringList &emails)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#59cd719b074257a7933fb1ccc767af89">getPhoneField</a> (PilotAddressInfo::EPhoneType type) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#44d941a6e25e177871ae25b75299cd0a">setPhoneField</a> (PilotAddressInfo::EPhoneType type, const QString &value, <a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f993847">PhoneHandlingFlags</a> flags)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#5209dce57806d7487ca54120f4af4328">getShownPhone</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#8631e4f31e51d39d56213f8109e556fd">setShownPhone</a> (PilotAddressInfo::EPhoneType phoneType)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#2861a6b6f74a0d30cd7253c0a3b3d2da">setShownPhone</a> (const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> &v)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">PilotAddressInfo::EPhoneType </td><td class="memItemRight" valign="bottom"><a class="el" href="classPilotAddress.html#7c70615e0019922e97df1c1aac4e0979">getPhoneType</a> (const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> &field) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a4765863d5cf1e0e24bca6451cc66213"></a><!-- doxytag: member="PilotAddress::pack" ref="a4765863d5cf1e0e24bca6451cc66213" args="() const " -->
<a class="el" href="classPilotRecord.html">PilotRecord</a> * </td><td class="memItemRight" valign="bottom"><b>pack</b> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8728d9b7553996c3bbf64ad2a83cd2ea"></a><!-- doxytag: member="PilotAddress::address" ref="8728d9b7553996c3bbf64ad2a83cd2ea" args="() const " -->
struct Address * </td><td class="memItemRight" valign="bottom"><b>address</b> () const </td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d3f268cda081929761bd2e6bf51767aa"></a><!-- doxytag: member="PilotAddress::getFieldP" ref="d3f268cda081929761bd2e6bf51767aa" args="(int field) const " -->
const char * </td><td class="memItemRight" valign="bottom"><b>getFieldP</b> (int field) const </td></tr>
</table>
<hr><h2>Member Enumeration Documentation</h2>
<a class="anchor" name="ff679d267be7c8f6c1d5521d2f993847"></a><!-- doxytag: member="PilotAddress::PhoneHandlingFlags" ref="ff679d267be7c8f6c1d5521d2f993847" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f993847">PilotAddress::PhoneHandlingFlags</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="ff679d267be7c8f6c1d5521d2f9938475bb8b2f53737e57ccf4768b3cf3265f6"></a><!-- doxytag: member="NoFlags" ref="ff679d267be7c8f6c1d5521d2f9938475bb8b2f53737e57ccf4768b3cf3265f6" args="" -->NoFlags</em> </td><td>
No special handling. </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ff679d267be7c8f6c1d5521d2f993847418404a8caea058eda1c25b5b46e8a74"></a><!-- doxytag: member="Replace" ref="ff679d267be7c8f6c1d5521d2f993847418404a8caea058eda1c25b5b46e8a74" args="" -->Replace</em> </td><td>
Replace existing entries of same type. </td></tr>
</table>
</dl>
<p>Definition at line <a class="el" href="pilotAddress_8h-source.html#l00245">245</a> of file <a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a>.</p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="3e541f0c6f914f818678cad8ba5d27eb"></a><!-- doxytag: member="PilotAddress::getTextRepresentation" ref="3e541f0c6f914f818678cad8ba5d27eb" args="(const PilotAddressInfo *info, Qt::TextFormat richText) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString PilotAddress::getTextRepresentation </td>
<td>(</td>
<td class="paramtype">const PilotAddressInfo * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Qt::TextFormat </td>
<td class="paramname"> <em>richText</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a text representation of the address.
<p>
If <code>richText</code> is true, the text will be formatted with Qt-HTML tags. The AppInfo structure <code>info</code> is used to figure out the phone labels; if it is NULL then bogus labels are used to identify phone types.
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00276">276</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="b9ce46f8467e1398e07add21331cb002"></a><!-- doxytag: member="PilotAddress::setField" ref="b9ce46f8467e1398e07add21331cb002" args="(int field, const QString &text)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void PilotAddress::setField </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>field</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>text</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>set the field value </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>int values associated with the enum defined in pi-address.h. The copied possible enum's are: (copied from pi-address.h on 1/12/01) enum { entryLastname, entryFirstname, entryCompany, entryPhone1, entryPhone2, entryPhone3, entryPhone4, entryPhone5, entryAddress, entryCity, entryState, entryZip, entryCountry, entryTitle, entryCustom1, entryCustom2, entryCustom3, entryCustom4, entryNote }; </td></tr>
</table>
</dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00602">602</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="f13f9e237daa8a1b51a2aff48beca72d"></a><!-- doxytag: member="PilotAddress::setField" ref="f13f9e237daa8a1b51a2aff48beca72d" args="(const PhoneSlot &i, const QString &t)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void PilotAddress::setField </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & </td>
<td class="paramname"> <em>i</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>t</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set a field <code>i</code> to a given text value.
<p>
Uses the phone slots only.
<p>Definition at line <a class="el" href="pilotAddress_8h-source.html#l00220">220</a> of file <a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a>.</p>
</div>
</div><p>
<a class="anchor" name="d3a5d11c6e70919518fb6e2dade797c5"></a><!-- doxytag: member="PilotAddress::getField" ref="d3a5d11c6e70919518fb6e2dade797c5" args="(int field) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString PilotAddress::getField </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>field</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the text value of a given field <code>field</code> (or QString::null if there is no such field).
<p>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00462">462</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="bdbcb9743f64b56181951bc1d7eb4c8e"></a><!-- doxytag: member="PilotAddress::getField" ref="bdbcb9743f64b56181951bc1d7eb4c8e" args="(const PhoneSlot &i) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString PilotAddress::getField </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & </td>
<td class="paramname"> <em>i</em> </td>
<td> ) </td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the value of the phone field <code>i</code> .
<p>
<p>Definition at line <a class="el" href="pilotAddress_8h-source.html#l00233">233</a> of file <a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a>.</p>
</div>
</div><p>
<a class="anchor" name="30f0c10eb8099bc537026dd8c1570fb4"></a><!-- doxytag: member="PilotAddress::getEmails" ref="30f0c10eb8099bc537026dd8c1570fb4" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QStringList PilotAddress::getEmails </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return list of all email addresses.
<p>
This will search through our "phone" fields and will return only those which are e-mail addresses.
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00416">416</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="59cd719b074257a7933fb1ccc767af89"></a><!-- doxytag: member="PilotAddress::getPhoneField" ref="59cd719b074257a7933fb1ccc767af89" args="(PilotAddressInfo::EPhoneType type) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString PilotAddress::getPhoneField </td>
<td>(</td>
<td class="paramtype">PilotAddressInfo::EPhoneType </td>
<td class="paramname"> <em>type</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>is the type of phone </td></tr>
<tr><td valign="top"></td><td valign="top"><em>checkCustom4</em> </td><td>flag if true, checks the entryCustom4 field for extra phone fields </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the field associated with the type </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00534">534</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="44d941a6e25e177871ae25b75299cd0a"></a><!-- doxytag: member="PilotAddress::setPhoneField" ref="44d941a6e25e177871ae25b75299cd0a" args="(PilotAddressInfo::EPhoneType type, const QString &value, PhoneHandlingFlags flags)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> PilotAddress::setPhoneField </td>
<td>(</td>
<td class="paramtype">PilotAddressInfo::EPhoneType </td>
<td class="paramname"> <em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classPilotAddress.html#ff679d267be7c8f6c1d5521d2f993847">PhoneHandlingFlags</a> </td>
<td class="paramname"> <em>flags</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>is the type of phone </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>is value to store </td></tr>
<tr><td valign="top"></td><td valign="top"><em>overflowCustom</em> </td><td>is true, and entryPhone1 to entryPhone5 is full it will use entryCustom4 field to store the field </td></tr>
<tr><td valign="top"></td><td valign="top"><em>overwriteExisting</em> </td><td>is true, it will overwrite an existing record-type with the field, else it will always search for the first available slot </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>index of the field that this information was set to </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00489">489</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="5209dce57806d7487ca54120f4af4328"></a><!-- doxytag: member="PilotAddress::getShownPhone" ref="5209dce57806d7487ca54120f4af4328" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> PilotAddress::getShownPhone </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the slot of the phone number selected by the user to be shown in the overview of addresses.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Slot of phone entry (between entryPhone1 and entryPhone5) </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00547">547</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="8631e4f31e51d39d56213f8109e556fd"></a><!-- doxytag: member="PilotAddress::setShownPhone" ref="8631e4f31e51d39d56213f8109e556fd" args="(PilotAddressInfo::EPhoneType phoneType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classPhoneSlot.html">PhoneSlot</a> PilotAddress::setShownPhone </td>
<td>(</td>
<td class="paramtype">PilotAddressInfo::EPhoneType </td>
<td class="paramname"> <em>phoneType</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the shown phone (the one preferred by the user for display on the handheld's overview page) to the <em>type</em> (not index) indicated.
<p>
Looks through the phone entries of this record to find the first one one of this type.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Slot of phone entry.</dd></dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Sets the shown phone to the first entry if no field of type <code>phoneType</code> can be found <em>and</em> no Home phone field (the fallback) can be found either. </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00563">563</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="2861a6b6f74a0d30cd7253c0a3b3d2da"></a><!-- doxytag: member="PilotAddress::setShownPhone" ref="2861a6b6f74a0d30cd7253c0a3b3d2da" args="(const PhoneSlot &v)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & PilotAddress::setShownPhone </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & </td>
<td class="paramname"> <em>v</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the shown phone (the one preferred by the user for display on the handheld's overview page) to the given <code>slot</code> .
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>v</code> </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00553">553</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<a class="anchor" name="7c70615e0019922e97df1c1aac4e0979"></a><!-- doxytag: member="PilotAddress::getPhoneType" ref="7c70615e0019922e97df1c1aac4e0979" args="(const PhoneSlot &field) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">PilotAddressInfo::EPhoneType PilotAddress::getPhoneType </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classPhoneSlot.html">PhoneSlot</a> & </td>
<td class="paramname"> <em>field</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the phone type (label) for a given field <code>field</code> in the record.
<p>
The <code>field</code> must be within the phone range (entryPhone1 .. entryPhone5).<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Phone type for phone field <code>field</code> . <p>
<code>eNone</code> (fake phone type) if <code>field</code> is invalid. </dd></dl>
<p>Definition at line <a class="el" href="pilotAddress_8cc-source.html#l00590">590</a> of file <a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a>.</p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="pilotAddress_8h-source.html">pilotAddress.h</a><li><a class="el" href="pilotAddress_8cc-source.html">pilotAddress.cc</a></ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kpilot/lib</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classActionQueue.html">actionqueue</option>, <option value="classCleanupAction.html">cleanupaction</option>, <option value="classConduitAction.html">conduitaction</option>, <option value="classConduitConfigBase.html">conduitconfigbase</option>, <option value="classConduitFactory.html">conduitfactory</option>, <option value="classConduitProxy.html">conduitproxy</option>, <option value="classCUDCounter.html">cudcounter</option>, <option value="classDatabaseInterpreter.html">databaseinterpreter</option>, <option value="classDeviceCommThread.html">devicecommthread</option>, <option value="classIDMapper.html">idmapper</option>, <option value="classKPilotDeviceLink.html">kpilotdevicelink</option>, <option value="classKPilotLink.html">kpilotlink</option>, <option value="classKPilotLocalLink.html">kpilotlocallink</option>, <option value="classNullMapper.html">nullmapper</option>, <option value="classPhoneSlot.html">phoneslot</option>, <option value="classPilotAddress.html">pilotaddress</option>, <option value="classPilotAppInfo.html">pilotappinfo</option>, <option value="classPilotAppInfoBase.html">pilotappinfobase</option>, <option value="classPilotDatabase.html">pilotdatabase</option>, <option value="classPilotDateEntry.html">pilotdateentry</option>, <option value="classPilotLocalDatabase.html">pilotlocaldatabase</option>, <option value="classPilotRecord.html">pilotrecord</option>, <option value="classPilotRecordBase.html">pilotrecordbase</option>, <option value="classPilotSerialDatabase.html">pilotserialdatabase</option>, <option value="classPilotTodoEntry.html">pilottodoentry</option>, <option value="classRecordConduitBase.html">recordconduitbase</option>, <option value="classSorryAction.html">sorryaction</option>, <option value="classSyncAction_1_1SyncMode.html">syncaction::syncmode</option>, <option value="classTestLink.html">testlink</option>, <option value="classWelcomeAction.html">welcomeaction</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../akregator/html/index.html">akregator</a></li><li> <a href="../../../akregator/src/html/index.html">src</a></li><li> <a href="../../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../../certmanager/html/index.html">certmanager</a></li><li> <a href="../../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../../kalarm/html/index.html">kalarm</a></li><li> <a href="../../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../../kandy/html/index.html">kandy</a></li><li><a href="../../../karm/html/index.html">karm</a></li><li><a href="../../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../../kgantt/html/index.html">kgantt</a></li><li><a href="../../../kioslaves/html/index.html">kioslaves</a></li><li> <a href="../../../kioslaves/imap4/html/index.html">imap4</a></li><li> <a href="../../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../../kmail/html/index.html">kmail</a></li><li><a href="../../../knotes/html/index.html">knotes</a></li><li><a href="../../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../../kontact/html/index.html">kontact</a></li><li><a href="../../../korganizer/html/index.html">korganizer</a></li><li><a href="../../../kpilot/html/index.html">kpilot</a></li><li> <a href="../../../kpilot/kpilot/html/index.html">kpilot</a></li><li> <a href="../../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../../libkcal/html/index.html">libkcal</a></li><li><a href="../../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../../libkmime/html/index.html">libkmime</a></li><li><a href="../../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../../libkpimidentities/html/index.html">libkpimidentities</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
