<?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>kaddressbook: KAddressBookView Class Reference (kaddressbook)</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=".">kaddressbook</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>kaddressbook</h2>
<!-- Generated by Doxygen 1.5.5 -->
<div class="contents">
<h1>KAddressBookView Class Reference</h1><!-- doxytag: class="KAddressBookView" --><!-- doxytag: inherits="QWidget" --><code>#include <<a class="el" href="kaddressbookview_8h-source.html">kaddressbookview.h</a>></code>
<p>
<div class="dynheader">
Inheritance diagram for KAddressBookView:</div>
<div class="dynsection">
<p><center><img src="classKAddressBookView.png" usemap="#KAddressBookView_map" border="0" alt=""></center>
<map name="KAddressBookView_map">
<area href="classKAddressBookCardView.html" alt="KAddressBookCardView" shape="rect" coords="0,56,154,80">
<area href="classKAddressBookIconView.html" alt="KAddressBookIconView" shape="rect" coords="164,56,318,80">
<area href="classKAddressBookTableView.html" alt="KAddressBookTableView" shape="rect" coords="328,56,482,80">
</map>
</div>
<p>
<a href="classKAddressBookView-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
Base class for all views in kaddressbook.
<p>
This class implements all the common methods needed to provide a view to the user.<p>
To implement a specific view (table, card, etc), just inherit from this class and implement all the pure virtuals.<p>
<dl class="author" compact><dt><b>Author:</b></dt><dd>Mike Pilone <<a href="mailto:mpilone@slac.com">mpilone@slac.com</a>> </dd></dl>
<p>Definition at line <a class="el" href="kaddressbookview_8h-source.html#l00056">56</a> of file <a class="el" href="kaddressbookview_8h-source.html">kaddressbookview.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"><b>DefaultFilterType</b> { <b>None</b> = 0,
<b>Active</b> = 1,
<b>Specific</b> = 2
}</td></tr>
<tr><td colspan="2"><br><h2>Public Slots</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#33052941465838c43b69b61653639d13">refresh</a> (const QString &uid=QString())=0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#b1f67bf8e83c72484b0aa308533c0979">setSelected</a> (const QString &uid=QString(), bool selected=true)=0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#c2269e27bb8c8ff06dfe2b9e3b3357c8">setFirstSelected</a> (bool selected=true)=0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#393668857b4292e6a2ad2ab958b00e73">popup</a> (const QPoint &point)</td></tr>
<tr><td colspan="2"><br><h2>Signals</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#cfcf83a3ca367f3a5422f2005853c063">modified</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#0d91b34d0d3c8c26ee8a7bfc05d03917">selected</a> (const QString &uid)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#30b20589bea5849e39e3d3a6432ef190">executed</a> (const QString &uid)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#0fb13d9787ab314956d67143ff37ea01">startDrag</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#e270f1a5e99eb385fb3ed8212fed4b7f">dropped</a> (QDropEvent *)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#dafe34db1b0d156f7b15e91b5aa70b8d">sortFieldChanged</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#2b7ea3e442d78408cfe9adfafeb5fc66">viewFieldsChanged</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="2d8c729e16bf5ca6f75970e3dde0a051"></a><!-- doxytag: member="KAddressBookView::KAddressBookView" ref="2d8c729e16bf5ca6f75970e3dde0a051" args="(KAB::Core *core, QWidget *parent, const char *name)" -->
</td><td class="memItemRight" valign="bottom"><b>KAddressBookView</b> (KAB::Core *core, QWidget *parent, const char *name)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual QStringList </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#8b372380967f1a2150ee2b700b2149a4">selectedUids</a> ()=0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#a57dbc0b432a252da27fc8afe81ef898">readConfig</a> (KConfig *config)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#b3cb4994491761243a0089869c36b33c">writeConfig</a> (KConfig *)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#39fcc2a6514a2690ac4ae89a40aaa067">selectedEmails</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#76149bcdfe0f05e536a9905af3909eba">type</a> () const =0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KABC::Field::List </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#f6ea8a3307cb9ed0e9f9737c878b9dbd">fields</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#3c79e2e2fecbef5ceb6479b494740d74">setFilter</a> (const <a class="el" href="classFilter.html">Filter</a> &)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">DefaultFilterType </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#8096d78bec403feaa38bc7f8b23a746f">defaultFilterType</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const QString & </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#3d6430760a156a68efcb45b5756ce891">defaultFilterName</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KAB::Core * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#244299d36e01633853f3b47c6eab8957">core</a> () const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual KABC::Field * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#78b2d39633cdf0a8de4000cabcfcee50">sortField</a> () const =0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dec384d3e38e3a9fdca0d336680fc6fb"></a><!-- doxytag: member="KAddressBookView::scrollUp" ref="dec384d3e38e3a9fdca0d336680fc6fb" args="()=0" -->
virtual void </td><td class="memItemRight" valign="bottom"><b>scrollUp</b> ()=0</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b237b767f8b4efa118f44a26f4a4c0d0"></a><!-- doxytag: member="KAddressBookView::scrollDown" ref="b237b767f8b4efa118f44a26f4a4c0d0" args="()=0" -->
virtual void </td><td class="memItemRight" valign="bottom"><b>scrollDown</b> ()=0</td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KABC::Addressee::List </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#99422071e971db4001f923c547ca88a4">addressees</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QWidget * </td><td class="memItemRight" valign="bottom"><a class="el" href="classKAddressBookView.html#3fef677398d04dab172c18bb35fd7314">viewWidget</a> ()</td></tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="8b372380967f1a2150ee2b700b2149a4"></a><!-- doxytag: member="KAddressBookView::selectedUids" ref="8b372380967f1a2150ee2b700b2149a4" args="()=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual QStringList KAddressBookView::selectedUids </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Must be overloaded in subclasses.
<p>
Should return a list of all the uids of selected contacts.
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#2585906140444a0b6c1e10e5dca8abb1">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#a761cbb529a536749c0e9e3da469d8e0">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#9dfc31c0c3d36813e4a71c5074f883a0">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="a57dbc0b432a252da27fc8afe81ef898"></a><!-- doxytag: member="KAddressBookView::readConfig" ref="a57dbc0b432a252da27fc8afe81ef898" args="(KConfig *config)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::readConfig </td>
<td>(</td>
<td class="paramtype">KConfig * </td>
<td class="paramname"> <em>config</em> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Called whenever this view should read the config.
<p>
This can be used as a sign that the config has changed, therefore the view should assume the worst and rebuild itself if necessary. For example, in a table view this method may be called when the user adds or removes columns from the view.<p>
If overloaded in the subclass, do not forget to call super class's method.<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>config</em> </td><td>The KConfig object to read from. The group will already be set, so do not change the group. </td></tr>
</table>
</dl>
<p>Reimplemented in <a class="el" href="classKAddressBookCardView.html#732d3117d8e181c73b29891d2b2df38f">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#ce6c63e9d015e5c4beb9eb7f79f8a9b1">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#66097068bd0b66ad13acd0384431e97c">KAddressBookTableView</a>.</p>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00056">56</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="b3cb4994491761243a0089869c36b33c"></a><!-- doxytag: member="KAddressBookView::writeConfig" ref="b3cb4994491761243a0089869c36b33c" args="(KConfig *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::writeConfig </td>
<td>(</td>
<td class="paramtype">KConfig * </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Called whenever this view should write the config.
<p>
The view should not write out information handled by the application, such as which fields are visible. The view should only write out information specific to itself (i.e.: All information in the ViewConfigWidget)<p>
If overloaded in the subclass, do not forget to call the super class's method.
<p>Reimplemented in <a class="el" href="classKAddressBookCardView.html#31a40f68f1139e077a816121638e425e">KAddressBookCardView</a>, and <a class="el" href="classKAddressBookTableView.html#7abc7e2f9723111b27977969a8bd92e8">KAddressBookTableView</a>.</p>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00067">67</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="39fcc2a6514a2690ac4ae89a40aaa067"></a><!-- doxytag: member="KAddressBookView::selectedEmails" ref="39fcc2a6514a2690ac4ae89a40aaa067" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString KAddressBookView::selectedEmails </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a QString with all the selected email addresses concatenated together with a ',' seperator.
<p>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00072">72</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="76149bcdfe0f05e536a9905af3909eba"></a><!-- doxytag: member="KAddressBookView::type" ref="76149bcdfe0f05e536a9905af3909eba" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual QString KAddressBookView::type </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return the type of the view: Icon, Table, etc.
<p>
Please make sure that this is the same value that ViewWrapper::type() will return for your view.
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#7f6ba812eedcf9042ca139714a2c632c">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#d38fd8305b36d1201edb2aabd223a8c6">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#960166662809a52980199ce67d4746c1">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="f6ea8a3307cb9ed0e9f9737c878b9dbd"></a><!-- doxytag: member="KAddressBookView::fields" ref="f6ea8a3307cb9ed0e9f9737c878b9dbd" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KABC::Field::List KAddressBookView::fields </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a list of the fields that should be displayed.
<p>
The list is composed of the fields proper names (ie: Home Address), so the view may need to translate them in order to get the value from the addressee.<p>
This list is generated from the config file, so it is advisable to call this method whenever a <a class="el" href="classKAddressBookView.html#a57dbc0b432a252da27fc8afe81ef898" title="Called whenever this view should read the config.">readConfig()</a> is called in order to get the newest list of fields.
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00132">132</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="3c79e2e2fecbef5ceb6479b494740d74"></a><!-- doxytag: member="KAddressBookView::setFilter" ref="3c79e2e2fecbef5ceb6479b494740d74" args="(const Filter &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::setFilter </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFilter.html">Filter</a> & </td>
<td class="paramname"> <em>filter</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the active filter.
<p>
This filter will be used for filtering the list of addressees to display. The view will <b>not</b> automatically refresh itself, so in most cases you will want to call <a class="el" href="classKAddressBookView.html#33052941465838c43b69b61653639d13" title="Must be overloaded in subclasses to refresh the view.">KAddressBookView::refresh()</a> after this method.
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00137">137</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="8096d78bec403feaa38bc7f8b23a746f"></a><!-- doxytag: member="KAddressBookView::defaultFilterType" ref="8096d78bec403feaa38bc7f8b23a746f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KAddressBookView::DefaultFilterType KAddressBookView::defaultFilterType </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The default filter type selection. If the selection is SpecificFilter, the name of the filter can be retrieved with <a class="el" href="classKAddressBookView.html#3d6430760a156a68efcb45b5756ce891">defaultFilterName()</a> </dd></dl>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00142">142</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="3d6430760a156a68efcb45b5756ce891"></a><!-- doxytag: member="KAddressBookView::defaultFilterName" ref="3d6430760a156a68efcb45b5756ce891" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const QString & KAddressBookView::defaultFilterName </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The name of the default filter. This string is only valid if <a class="el" href="classKAddressBookView.html#8096d78bec403feaa38bc7f8b23a746f">defaultFilterType()</a> is returning SpecificFilter. </dd></dl>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00147">147</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="244299d36e01633853f3b47c6eab8957"></a><!-- doxytag: member="KAddressBookView::core" ref="244299d36e01633853f3b47c6eab8957" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KAB::Core * KAddressBookView::core </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The Core object. </dd></dl>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00152">152</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="78b2d39633cdf0a8de4000cabcfcee50"></a><!-- doxytag: member="KAddressBookView::sortField" ref="78b2d39633cdf0a8de4000cabcfcee50" args="() const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual KABC::Field* KAddressBookView::sortField </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The current sort field. </dd></dl>
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#afb662e00e449c2d4e96fd5405982361">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#7dcb6a59f2bad4eaaca04514576ee9a9">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#697be5c08b7a4b6bae403502ca774946">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="33052941465838c43b69b61653639d13"></a><!-- doxytag: member="KAddressBookView::refresh" ref="33052941465838c43b69b61653639d13" args="(const QString &uid=QString())=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KAddressBookView::refresh </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>uid</em> = <code>QString()</code> </td>
<td> ) </td>
<td width="100%"><code> [pure virtual, slot]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Must be overloaded in subclasses to refresh the view.
<p>
Refreshing includes updating the view to ensure that only items in the document are visible. If <em>uid</em> is valid, only the addressee with uid needs to be refreshed. This is an optimization only.
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#19b76d340967bb913d92671da01aab60">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#075c73e9db421280f3d14250cf9e65cc">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#4ff0769517168fe1e240056e9e54e41c">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="b1f67bf8e83c72484b0aa308533c0979"></a><!-- doxytag: member="KAddressBookView::setSelected" ref="b1f67bf8e83c72484b0aa308533c0979" args="(const QString &uid=QString(), bool selected=true)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KAddressBookView::setSelected </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>uid</em> = <code>QString()</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>selected</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [pure virtual, slot]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This method must be overloaded in subclasses.
<p>
Select (highlight) the addressee matching <em>uid</em>. If uid is equal to QString::null, then all addressees should be selected.
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#f2bdfa6177a278680acc1891846cf7d7">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#fc196129a0a46cfdb56dd0284c7f0998">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#8617c040f395dfc2dbc38b92f3df5824">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="c2269e27bb8c8ff06dfe2b9e3b3357c8"></a><!-- doxytag: member="KAddressBookView::setFirstSelected" ref="c2269e27bb8c8ff06dfe2b9e3b3357c8" args="(bool selected=true)=0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void KAddressBookView::setFirstSelected </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>selected</em> = <code>true</code> </td>
<td> ) </td>
<td width="100%"><code> [pure virtual, slot]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Selects the first contact in the view.
<p>
<p>Implemented in <a class="el" href="classKAddressBookCardView.html#d08a39d5b9c0dcdd977e593b8535f4e3">KAddressBookCardView</a>, <a class="el" href="classKAddressBookIconView.html#ee247538deec4b4fbe1188d10563ffb5">KAddressBookIconView</a>, and <a class="el" href="classKAddressBookTableView.html#a750500426f894e3049175e5b1637035">KAddressBookTableView</a>.</p>
</div>
</div><p>
<a class="anchor" name="393668857b4292e6a2ad2ab958b00e73"></a><!-- doxytag: member="KAddressBookView::popup" ref="393668857b4292e6a2ad2ab958b00e73" args="(const QPoint &point)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::popup </td>
<td>(</td>
<td class="paramtype">const QPoint & </td>
<td class="paramname"> <em>point</em> </td>
<td> ) </td>
<td width="100%"><code> [slot]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Call this slot to popup a rmb menu.
<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>point</em> </td><td>The position where the menu shall appear. </td></tr>
</table>
</dl>
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00157">157</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="cfcf83a3ca367f3a5422f2005853c063"></a><!-- doxytag: member="KAddressBookView::modified" ref="cfcf83a3ca367f3a5422f2005853c063" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::modified </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal should be emitted by a subclass whenever an addressee is modified.
<p>
</div>
</div><p>
<a class="anchor" name="0d91b34d0d3c8c26ee8a7bfc05d03917"></a><!-- doxytag: member="KAddressBookView::selected" ref="0d91b34d0d3c8c26ee8a7bfc05d03917" args="(const QString &uid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::selected </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>uid</em> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal should be emitted by a subclass whenever an addressee is selected.
<p>
Selected means that the addressee was given the focus. Some widgets may call this 'highlighted'. The view is responsible for emitting this signal multiple times if multiple items are selected, with the last item selected being the last emit.<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>uid</em> </td><td>The uid of the selected addressee.</td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>KListView </dd></dl>
</div>
</div><p>
<a class="anchor" name="30b20589bea5849e39e3d3a6432ef190"></a><!-- doxytag: member="KAddressBookView::executed" ref="30b20589bea5849e39e3d3a6432ef190" args="(const QString &uid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::executed </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>uid</em> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal should be emitted by a subclass whenever an addressee is executed.
<p>
This is defined by the KDE system wide config, but it either means single or doubleclicked.<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>uid</em> </td><td>The uid of the selected addressee</td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>KListView </dd></dl>
</div>
</div><p>
<a class="anchor" name="0fb13d9787ab314956d67143ff37ea01"></a><!-- doxytag: member="KAddressBookView::startDrag" ref="0fb13d9787ab314956d67143ff37ea01" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::startDrag </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal is emitted whenever a user attempts to start a drag in the view.
<p>
The slot connected to this signal would usually want to create a QDragObject.
</div>
</div><p>
<a class="anchor" name="e270f1a5e99eb385fb3ed8212fed4b7f"></a><!-- doxytag: member="KAddressBookView::dropped" ref="e270f1a5e99eb385fb3ed8212fed4b7f" args="(QDropEvent *)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::dropped </td>
<td>(</td>
<td class="paramtype">QDropEvent * </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal is emitted whenever the user drops something on the view.
<p>
The individual view should handle checking if the item is droppable (ie: if it is a vcard).
</div>
</div><p>
<a class="anchor" name="dafe34db1b0d156f7b15e91b5aa70b8d"></a><!-- doxytag: member="KAddressBookView::sortFieldChanged" ref="dafe34db1b0d156f7b15e91b5aa70b8d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::sortFieldChanged </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This signal is emitted whenever the sort field changed.
<p>
</div>
</div><p>
<a class="anchor" name="2b7ea3e442d78408cfe9adfafeb5fc66"></a><!-- doxytag: member="KAddressBookView::viewFieldsChanged" ref="2b7ea3e442d78408cfe9adfafeb5fc66" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KAddressBookView::viewFieldsChanged </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Emitted whenever the view fields changed.
<p>
</div>
</div><p>
<a class="anchor" name="99422071e971db4001f923c547ca88a4"></a><!-- doxytag: member="KAddressBookView::addressees" ref="99422071e971db4001f923c547ca88a4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KABC::Addressee::List KAddressBookView::addressees </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a list of the addressees that should be displayed.
<p>
This method should always be used by the subclass to get a list of addressees. This method internally takes many factors into account, including the current filter.
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00104">104</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="3fef677398d04dab172c18bb35fd7314"></a><!-- doxytag: member="KAddressBookView::viewWidget" ref="3fef677398d04dab172c18bb35fd7314" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QWidget * KAddressBookView::viewWidget </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
This method returns the widget that should be used as the parent for all view components.
<p>
By using this widget as the parent and not 'this', the view subclass has the option of placing other widgets around the view (ie: search fields, etc). Do not delete this widget!
<p>Definition at line <a class="el" href="kaddressbookview_8cpp-source.html#l00170">170</a> of file <a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a>.</p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kaddressbookview_8h-source.html">kaddressbookview.h</a><li><a class="el" href="kaddressbookview_8cpp-source.html">kaddressbookview.cpp</a></ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kaddressbook</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</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="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</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="classAddressEditDialog.html">addresseditdialog</option>, <option value="classAddressEditWidget.html">addresseditwidget</option>, <option value="classAddresseeUtil.html">addresseeutil</option>, <option value="classAddressTypeDialog.html">addresstypedialog</option>, <option value="classAddViewDialog.html">addviewdialog</option>, <option value="classCardView.html">cardview</option>, <option value="classCardViewItem.html">cardviewitem</option>, <option value="classCardViewLookNFeelPage.html">cardviewlooknfeelpage</option>, <option value="classConfigureCardViewWidget.html">configurecardviewwidget</option>, <option value="classConfigureTableViewWidget.html">configuretableviewwidget</option>, <option value="classDateParser.html">dateparser</option>, <option value="classDistributionListView.html">distributionlistview</option>, <option value="classDynamicTip.html">dynamictip</option>, <option value="classEmailEditWidget.html">emaileditwidget</option>, <option value="classEmailSelector.html">emailselector</option>, <option value="classFilter.html">filter</option>, <option value="classFilterSelectionWidget.html">filterselectionwidget</option>, <option value="classIMAddressLVI.html">imaddresslvi</option>, <option value="classIMAddressWidget.html">imaddresswidget</option>, <option value="classImageButton.html">imagebutton</option>, <option value="classImageLoader.html">imageloader</option>, <option value="classIMEditorWidget.html">imeditorwidget</option>, <option value="classIMEditWidget.html">imeditwidget</option>, <option value="classJumpButtonBar.html">jumpbuttonbar</option>, <option value="classKABPrinting_1_1PrintingWizard.html">kabprinting::printingwizard</option>, <option value="classKABPrinting_1_1PrintProgress.html">kabprinting::printprogress</option>, <option value="classKABPrinting_1_1PrintStyle.html">kabprinting::printstyle</option>, <option value="classKABPrinting_1_1PrintStyleFactory.html">kabprinting::printstylefactory</option>, <option value="classKAddressBookCardView.html">kaddressbookcardview</option>, <option value="classKAddressBookIconView.html">kaddressbookiconview</option>, <option value="classKAddressBookMain.html">kaddressbookmain</option>, <option value="classKAddressBookTableView.html">kaddressbooktableview</option>, <option value="classKAddressBookView.html">kaddressbookview</option>, <option value="classLookAndFeelPage.html">lookandfeelpage</option>, <option value="classNameEditDialog.html">nameeditdialog</option>, <option value="classPhoneEditWidget.html">phoneeditwidget</option>, <option value="classPhoneTypeDialog.html">phonetypedialog</option>, <option value="classTypeCombo.html">typecombo</option>, <option value="classViewConfigureWidget.html">viewconfigurewidget</option>, <option value="classViewManager.html">viewmanager</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>
