<?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>libkdepim: KPIM Namespace Reference (libkdepim)</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=".">libkdepim</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>libkdepim</h2>
<!-- Generated by Doxygen 1.5.5 -->
<div class="contents">
<h1>KPIM Namespace Reference</h1><hr><a name="_details"></a><h2>Detailed Description</h2>
KDEPIM classes for drag and drop of mails.
<p>
-*- c++ -*- <a class="el" href="progressdialog_8cpp-source.html">progressdialog.cpp</a><p>
// Code example for drag and drop enabled widget<p>
void SomeWidget::contentsDropEvent(QDropEvent *e) { if (e->provides(MailListDrag::format())) { MailList mailList; MailListDrag::decode( e, mailList ); ...<p>
Copyright (c) 2004 Till Adam <<a href="mailto:adam@kde.org">adam@kde.org</a>>, David Faure <<a href="mailto:faure@kde.org">faure@kde.org</a>><p>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License<p>
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<p>
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<p>
In addition, as a special exception, the copyright holders give permission to link the code of this program with any edition of the Qt library by Trolltech AS, Norway (or with modified versions of Qt that use the same license as Qt), and distribute linked combinations including the two. You must obey the GNU General Public License in all respects for all of the code used other than Qt. If you modify this file, you may extend this exception to your version of the file, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.
<p>
<p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1SelectionItem.html">SelectionItem</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Internal helper class. <a href="classKPIM_1_1SelectionItem.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1BroadcastStatus.html">BroadcastStatus</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides a singleton which broadcasts status messages by emitting signals. <a href="classKPIM_1_1BroadcastStatus.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1ClickLineEdit.html">ClickLineEdit</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This class provides a KLineEdit which contains a greyed-out hinting text as long as the user didn't enter any text. <a href="classKPIM_1_1ClickLineEdit.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1CollectingProcess.html">CollectingProcess</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An output collecting KProcess class. <a href="classKPIM_1_1CollectingProcess.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1ConfigManager.html">ConfigManager</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Class for managing a set of config options. <a href="classKPIM_1_1ConfigManager.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1DiffAlgoDisplay.html">DiffAlgoDisplay</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">DiffAlgo and <a class="el" href="classKPIM_1_1DiffAlgoDisplay.html" title="DiffAlgo and DiffAlgoDisplay work together for displaying differences between two...">DiffAlgoDisplay</a> work together for displaying differences between two PIM objects like contacts, events or todos. <a href="classKPIM_1_1DiffAlgoDisplay.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1DistributionList.html">DistributionList</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Distribution list of email addresses. <a href="classKPIM_1_1DistributionList.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1KMailCompletion.html">KMailCompletion</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classKPIM_1_1KMailCompletion.html" title="KMailCompletion allows lookup of email addresses by keyword.">KMailCompletion</a> allows lookup of email addresses by keyword. <a href="classKPIM_1_1KMailCompletion.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1KPixmapRegionSelectorDialog.html">KPixmapRegionSelectorDialog</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A dialog that uses a <a class="el" href="classKPIM_1_1KPixmapRegionSelectorWidget.html" title="KPixmapRegionSelectorWidget is a widget that shows a picture and provides the user...">KPixmapRegionSelectorWidget</a> to allow the user to select a region of an image. <a href="classKPIM_1_1KPixmapRegionSelectorDialog.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1KPixmapRegionSelectorWidget.html">KPixmapRegionSelectorWidget</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classKPIM_1_1KPixmapRegionSelectorWidget.html" title="KPixmapRegionSelectorWidget is a widget that shows a picture and provides the user...">KPixmapRegionSelectorWidget</a> is a widget that shows a picture and provides the user with a friendly way to select a rectangular subregion of the pixmap. <a href="classKPIM_1_1KPixmapRegionSelectorWidget.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1LdapObject.html">LdapObject</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This class is internal. <a href="classKPIM_1_1LdapObject.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1LdapClient.html">LdapClient</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This class is internal. <a href="classKPIM_1_1LdapClient.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structKPIM_1_1LdapResult.html">LdapResult</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing one result returned by a LDAP query. <a href="structKPIM_1_1LdapResult.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1LdapSearch.html">LdapSearch</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This class is internal. <a href="classKPIM_1_1LdapSearch.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1OverlayWidget.html">OverlayWidget</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This is a widget that can align itself with another one, without using a layout, so that it can actually be on top of other widgets. <a href="classKPIM_1_1OverlayWidget.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1PluginLoader.html">PluginLoader</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A generic plugin loader for when KPart::Plugin is overkill. <a href="classKPIM_1_1PluginLoader.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1ProgressManager.html">ProgressManager</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The <a class="el" href="classKPIM_1_1ProgressManager.html" title="The ProgressManager singleton keeps track of all ongoing transactions and notifies...">ProgressManager</a> singleton keeps track of all ongoing transactions and notifies observers (progress dialogs) when their progress percent value changes, when they are completed (by their owner), and when they are canceled. <a href="classKPIM_1_1ProgressManager.html#_details">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classKPIM_1_1ResourceABC.html">ResourceABC</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This class is the implementation of subfolder resources for KABC. <a href="classKPIM_1_1ResourceABC.html#_details">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a1f75cfd18003880c20892d5ec8314a6"></a><!-- doxytag: member="KPIM::LdapResultList" ref="a1f75cfd18003880c20892d5ec8314a6" args="" -->
typedef QValueList< <a class="el" href="structKPIM_1_1LdapResult.html">LdapResult</a> > </td><td class="memItemRight" valign="bottom"><b>LdapResultList</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d5db9c6b5406a70615f3c3fb57b68433"></a><!-- doxytag: member="KPIM::CompletionItemsMap" ref="d5db9c6b5406a70615f3c3fb57b68433" args="" -->
typedef QMap< QString, QPair<br>
< int, int > > </td><td class="memItemRight" valign="bottom"><b>CompletionItemsMap</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ec3ee25fa262323aca16092dfa1f053d"></a><!-- doxytag: member="KPIM::LdapAttrValue" ref="ec3ee25fa262323aca16092dfa1f053d" args="" -->
typedef QValueList< QByteArray > </td><td class="memItemRight" valign="bottom"><b>LdapAttrValue</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dc2b87646002b4719f3388a011b9ae1c"></a><!-- doxytag: member="KPIM::LdapAttrMap" ref="dc2b87646002b4719f3388a011b9ae1c" args="" -->
typedef QMap< QString, <br>
LdapAttrValue > </td><td class="memItemRight" valign="bottom"><b>LdapAttrMap</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3eb0bb382d1fd429c0a478a23c34ce69"></a><!-- doxytag: member="KPIM::MailList" ref="3eb0bb382d1fd429c0a478a23c34ce69" args="" -->
typedef QValueList< MailSummary > </td><td class="memItemRight" valign="bottom"><b>MailList</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="433837e3af00338c7d9409bec4825612"></a><!-- doxytag: member="KPIM::ProgressItemMap" ref="433837e3af00338c7d9409bec4825612" args="" -->
typedef QMap< ProgressItem <br>
*, bool > </td><td class="memItemRight" valign="bottom"><b>ProgressItemMap</b></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a11ccdf347f9485ddbcc364405f7eee8"></a><!-- doxytag: member="KPIM::swapItems" ref="a11ccdf347f9485ddbcc364405f7eee8" args="(CompletionViewItem *one, CompletionViewItem *other)" -->
static void </td><td class="memItemRight" valign="bottom"><b>swapItems</b> (CompletionViewItem *one, CompletionViewItem *other)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="494204c755b0bdf6c24344e22483580c"></a><!-- doxytag: member="KPIM::darker" ref="494204c755b0bdf6c24344e22483580c" args="(const QColor &c)" -->
QColor </td><td class="memItemRight" valign="bottom"><b>darker</b> (const QColor &c)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="471e223ef471a236a57dabe40ff09cb5"></a><!-- doxytag: member="KPIM::desaturate" ref="471e223ef471a236a57dabe40ff09cb5" args="(const QColor &c)" -->
QColor </td><td class="memItemRight" valign="bottom"><b>desaturate</b> (const QColor &c)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="fb45c627c9b74075586cac19e5b97d2c"></a><!-- doxytag: member="KPIM::fixValue" ref="fb45c627c9b74075586cac19e5b97d2c" args="(const QColor &c, int newV)" -->
QColor </td><td class="memItemRight" valign="bottom"><b>fixValue</b> (const QColor &c, int newV)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="41b867c5714ba61cbf23d148cd439159"></a><!-- doxytag: member="KPIM::getValueOf" ref="41b867c5714ba61cbf23d148cd439159" args="(const QColor &c)" -->
int </td><td class="memItemRight" valign="bottom"><b>getValueOf</b> (const QColor &c)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ae342f6e81132efd4263736e0d333b99"></a><!-- doxytag: member="KPIM::pointsToPixel" ref="ae342f6e81132efd4263736e0d333b99" args="(const QPaintDeviceMetrics &metrics, int pointSize)" -->
int </td><td class="memItemRight" valign="bottom"><b>pointsToPixel</b> (const QPaintDeviceMetrics &metrics, int pointSize)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="bc4da88783d646b3469cabc253a13b5b"></a><!-- doxytag: member="KPIM::msgDialog" ref="bc4da88783d646b3469cabc253a13b5b" args="(const QString &msg)" -->
static void </td><td class="memItemRight" valign="bottom"><b>msgDialog</b> (const QString &msg)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KDE_EXPORT QCString </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceKPIM.html#6467b24bd3d0809b45168fb369eb6498">kFileToString</a> (const QString &fileName, bool ensureNewline=true, bool withDialogs=true) KDE_EXPORT</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KDE_EXPORT bool </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceKPIM.html#f82cd8013cd0c99ca4183c9c77f2ee4c">kBytesToFile</a> (const char *aBuffer, int len, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose) KDE_EXPORT</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="05f3a55580b472844c7da9e51be9a647"></a><!-- doxytag: member="KPIM::kCStringToFile" ref="05f3a55580b472844c7da9e51be9a647" args="(const QCString &aBuffer, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose)" -->
KDE_EXPORT bool </td><td class="memItemRight" valign="bottom"><b>kCStringToFile</b> (const QCString &aBuffer, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">KDE_EXPORT bool </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceKPIM.html#8be2b3dd1d3bcce2dc896205406ac7df">kByteArrayToFile</a> (const QByteArray &buffer, const QString &fileName, bool askIfExists=false, bool createBackup=true, bool withDialogs=true) KDE_EXPORT</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceKPIM.html#a13ba4b942d1a5bb99110aaf9240a6c5">checkAndCorrectPermissionsIfPossible</a> (const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceKPIM.html#675eb4e8b31321a36e1e5af34e1116d7">checkAndCorrectPermissionsIfPossibleWithErrorHandling</a> (QWidget *parent, const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)</td></tr>
<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static const char *const </td><td class="memItemRight" valign="bottom"><b>AddressBookServiceIface_ftable</b> [3][3]</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static const int </td><td class="memItemRight" valign="bottom"><b>AddressBookServiceIface_ftable_hiddens</b> [2]</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static const char *const </td><td class="memItemRight" valign="bottom"><b>AddresseeLineEdit_ftable</b> [2][3]</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static const int </td><td class="memItemRight" valign="bottom"><b>AddresseeLineEdit_ftable_hiddens</b> [1]</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3fe713dd040840a1a4773a8327d63b89"></a><!-- doxytag: member="KPIM::quoteFontSizes" ref="3fe713dd040840a1a4773a8327d63b89" args="[]" -->
static const char *const </td><td class="memItemRight" valign="bottom"><b>quoteFontSizes</b> [] = { "85", "80", "75" }</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7fe7642cd626a5111f8bc3a2f5437d37"></a><!-- doxytag: member="KPIM::progressManagerDeleter" ref="7fe7642cd626a5111f8bc3a2f5437d37" args="" -->
static KStaticDeleter<br>
< <a class="el" href="classKPIM_1_1ProgressManager.html">ProgressManager</a> > </td><td class="memItemRight" valign="bottom"><b>progressManagerDeleter</b></td></tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="a13ba4b942d1a5bb99110aaf9240a6c5"></a><!-- doxytag: member="KPIM::checkAndCorrectPermissionsIfPossible" ref="a13ba4b942d1a5bb99110aaf9240a6c5" args="(const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QString KPIM::checkAndCorrectPermissionsIfPossible </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>toCheck</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>wantItReadable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>wantItWritable</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>
Checks and corrects the permissions of a file or folder, and if requested all files and folders below.
<p>
It gives back a list of files which do not have the right permissions. This list can be used to show to the user.<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>toCheck</em> </td><td>The file or folder of which the permissions should be checked. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>recursive</em> </td><td>Set to true, it will check the contents of a folder for the permissions recursively. If false only toCheck will be checked. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wantItReadable</em> </td><td>Set to true, it will check for read permissions. If the read permissions are not available, there will be a attempt to correct this. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wantItWritable</em> </td><td>Set to true, it will check for write permissions. If the write permissions are not available, there will be a attempt to correct this. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>It will return a string with all files and folders which do not have the right permissions. If empty, then all permissions are ok. </dd></dl>
<p>Definition at line <a class="el" href="kfileio_8cpp-source.html#l00271">271</a> of file <a class="el" href="kfileio_8cpp-source.html">kfileio.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="675eb4e8b31321a36e1e5af34e1116d7"></a><!-- doxytag: member="KPIM::checkAndCorrectPermissionsIfPossibleWithErrorHandling" ref="675eb4e8b31321a36e1e5af34e1116d7" args="(QWidget *parent, const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KPIM::checkAndCorrectPermissionsIfPossibleWithErrorHandling </td>
<td>(</td>
<td class="paramtype">QWidget * </td>
<td class="paramname"> <em>parent</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>toCheck</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>wantItReadable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const bool </td>
<td class="paramname"> <em>wantItWritable</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>
Checks and corrects the permissions of a file or folder, and if requested all files and folders below.
<p>
If the permissions are not ok, it tries to correct them. If that fails then a warning with detailled information is given.<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>parent</em> </td><td>If parent is 0, then the message box becomes an application-global modal dialog box. If parent is a widget, the message box becomes modal relative to parent. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>toCheck</em> </td><td>The file or folder of which the permissions should be checked. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>recursive</em> </td><td>Set to true, it will check the contents of a folder for the permissions recursively. If false only toCheck will be checked. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wantItReadable</em> </td><td>Set to true, it will check for read permissions. If the read permissions are not available, there will be a attempt to correct this. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wantItWritable</em> </td><td>Set to true, it will check for write permissions. If the write permissions are not available, there will be a attempt to correct this. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>It will return true if all permissions in the end are ok. If false then the permissions are not ok and it was not possible to correct all errors. </dd></dl>
<p>Definition at line <a class="el" href="kfileio_8cpp-source.html#l00368">368</a> of file <a class="el" href="kfileio_8cpp-source.html">kfileio.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="8be2b3dd1d3bcce2dc896205406ac7df"></a><!-- doxytag: member="KPIM::kByteArrayToFile" ref="8be2b3dd1d3bcce2dc896205406ac7df" args="(const QByteArray &buffer, const QString &fileName, bool askIfExists=false, bool createBackup=true, bool withDialogs=true) KDE_EXPORT" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KDE_EXPORT bool KPIM::kByteArrayToFile </td>
<td>(</td>
<td class="paramtype">const QByteArray & </td>
<td class="paramname"> <em>aBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>aFileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aAskIfExists</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aBackup</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aVerbose</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>
Does not stop at NUL.
<p>
<p>Definition at line <a class="el" href="kfileio_8cpp-source.html#l00263">263</a> of file <a class="el" href="kfileio_8cpp-source.html">kfileio.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="f82cd8013cd0c99ca4183c9c77f2ee4c"></a><!-- doxytag: member="KPIM::kBytesToFile" ref="f82cd8013cd0c99ca4183c9c77f2ee4c" args="(const char *aBuffer, int len, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose) KDE_EXPORT" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KPIM::kBytesToFile </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>aBuffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>aFileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aAskIfExists</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aBackup</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>aVerbose</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>
Save a file.
<p>
If withDialogs is FALSE no warning dialogs are opened if there are problems. Returns TRUE on success and FALSE on failure. Replaces existing files without warning if askIfExists==FALSE. Makes a copy if the file exists to filename~ if createBackup==TRUE.
<p>Definition at line <a class="el" href="kfileio_8cpp-source.html#l00176">176</a> of file <a class="el" href="kfileio_8cpp-source.html">kfileio.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="6467b24bd3d0809b45168fb369eb6498"></a><!-- doxytag: member="KPIM::kFileToString" ref="6467b24bd3d0809b45168fb369eb6498" args="(const QString &fileName, bool ensureNewline=true, bool withDialogs=true) KDE_EXPORT" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QCString KPIM::kFileToString </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>fileName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>ensureNewline</em> = <code>true</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>withDialogs</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Load a file.
<p>
Returns a pointer to the memory-block that contains the loaded file. Returns a null string if the file could not be loaded. If withDialogs is FALSE no warning dialogs are opened if there are problems. The string returned is always zero-terminated and therefore one byte longer than the file itself. If ensureNewline is TRUE the string will always have a trailing newline.
<p>Definition at line <a class="el" href="kfileio_8cpp-source.html#l00036">36</a> of file <a class="el" href="kfileio_8cpp-source.html">kfileio.cpp</a>.</p>
</div>
</div><p>
<hr><h2>Variable Documentation</h2>
<a class="anchor" name="533ce03ee9c7d6261c33696cb8817450"></a><!-- doxytag: member="KPIM::AddressBookServiceIface_ftable" ref="533ce03ee9c7d6261c33696cb8817450" args="[3][3]" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* const KPIM::AddressBookServiceIface_ftable[3][3]<code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Initial value:</b><div class="fragment"><pre class="fragment"> {
{ <span class="stringliteral">"void"</span>, <span class="stringliteral">"importVCardFromData(QString)"</span>, <span class="stringliteral">"importVCardFromData(QString vCard)"</span> },
{ <span class="stringliteral">"void"</span>, <span class="stringliteral">"importVCard(KURL)"</span>, <span class="stringliteral">"importVCard(KURL url)"</span> },
{ 0, 0, 0 }
}
</pre></div>
<p>Definition at line <a class="el" href="AddressBookServiceIface__skel_8cpp-source.html#l00015">15</a> of file <a class="el" href="AddressBookServiceIface__skel_8cpp-source.html">AddressBookServiceIface_skel.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="ea9da30b3f55e6479648fef904c72d69"></a><!-- doxytag: member="KPIM::AddressBookServiceIface_ftable_hiddens" ref="ea9da30b3f55e6479648fef904c72d69" args="[2]" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const int KPIM::AddressBookServiceIface_ftable_hiddens[2]<code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Initial value:</b><div class="fragment"><pre class="fragment"> {
0,
0,
}
</pre></div>
<p>Definition at line <a class="el" href="AddressBookServiceIface__skel_8cpp-source.html#l00020">20</a> of file <a class="el" href="AddressBookServiceIface__skel_8cpp-source.html">AddressBookServiceIface_skel.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="674082d6db5e11dd97b2259fd8de4ff1"></a><!-- doxytag: member="KPIM::AddresseeLineEdit_ftable" ref="674082d6db5e11dd97b2259fd8de4ff1" args="[2][3]" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* const KPIM::AddresseeLineEdit_ftable[2][3]<code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Initial value:</b><div class="fragment"><pre class="fragment"> {
{ <span class="stringliteral">"void"</span>, <span class="stringliteral">"slotIMAPCompletionOrderChanged()"</span>, <span class="stringliteral">"slotIMAPCompletionOrderChanged()"</span> },
{ 0, 0, 0 }
}
</pre></div>
<p>Definition at line <a class="el" href="addresseelineedit__skel_8cpp-source.html#l00015">15</a> of file <a class="el" href="addresseelineedit__skel_8cpp-source.html">addresseelineedit_skel.cpp</a>.</p>
</div>
</div><p>
<a class="anchor" name="a6bf526f312e244d51fd711c3011023c"></a><!-- doxytag: member="KPIM::AddresseeLineEdit_ftable_hiddens" ref="a6bf526f312e244d51fd711c3011023c" args="[1]" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const int KPIM::AddresseeLineEdit_ftable_hiddens[1]<code> [static]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Initial value:</b><div class="fragment"><pre class="fragment"> {
0,
}
</pre></div>
<p>Definition at line <a class="el" href="addresseelineedit__skel_8cpp-source.html#l00019">19</a> of file <a class="el" href="addresseelineedit__skel_8cpp-source.html">addresseelineedit_skel.cpp</a>.</p>
</div>
</div><p>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>libkdepim</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="classActionBase.html">actionbase</option>, <option value="classActionEditWidget.html">actioneditwidget</option>, <option value="classAlarmClient.html">alarmclient</option>, <option value="classConditionEditWidget.html">conditioneditwidget</option>, <option value="classGroupItem.html">groupitem</option>, <option value="classKABC_1_1ResourceNull.html">kabc::resourcenull</option>, <option value="classKConfigWizard.html">kconfigwizard</option>, <option value="classKDateEdit.html">kdateedit</option>, <option value="classKDatePickerPopup.html">kdatepickerpopup</option>, <option value="classKIncidenceChooser.html">kincidencechooser</option>, <option value="classKomposer_1_1Core.html">komposer::core</option>, <option value="classKomposer_1_1KomposerIface.html">komposer::komposeriface</option>, <option value="classKParts_1_1InfoExtension.html">kparts::infoextension</option>, <option value="classKParts_1_1SideBarExtension.html">kparts::sidebarextension</option>, <option value="classKPartsGenericPart.html">kpartsgenericpart</option>, <option value="classKPartsWidgetPlugin.html">kpartswidgetplugin</option>, <option value="classKPIM_1_1BroadcastStatus.html">kpim::broadcaststatus</option>, <option value="classKPIM_1_1ClickLineEdit.html">kpim::clicklineedit</option>, <option value="classKPIM_1_1CollectingProcess.html">kpim::collectingprocess</option>, <option value="classKPIM_1_1ConfigManager.html">kpim::configmanager</option>, <option value="classKPIM_1_1DiffAlgoDisplay.html">kpim::diffalgodisplay</option>, <option value="classKPIM_1_1DistributionList.html">kpim::distributionlist</option>, <option value="classKPIM_1_1KMailCompletion.html">kpim::kmailcompletion</option>, <option value="classKPIM_1_1KPixmapRegionSelectorDialog.html">kpim::kpixmapregionselectordialog</option>, <option value="classKPIM_1_1KPixmapRegionSelectorWidget.html">kpim::kpixmapregionselectorwidget</option>, <option value="classKPIM_1_1LdapClient.html">kpim::ldapclient</option>, <option value="classKPIM_1_1LdapObject.html">kpim::ldapobject</option>, <option value="classKPIM_1_1LdapSearch.html">kpim::ldapsearch</option>, <option value="classKPIM_1_1OverlayWidget.html">kpim::overlaywidget</option>, <option value="classKPIM_1_1PluginLoader.html">kpim::pluginloader</option>, <option value="classKPIM_1_1ProgressManager.html">kpim::progressmanager</option>, <option value="classKPIM_1_1ResourceABC.html">kpim::resourceabc</option>, <option value="classKPIM_1_1SelectionItem.html">kpim::selectionitem</option>, <option value="classKPIM_1_1ThreadWeaver_1_1Event.html">kpim::threadweaver::event</option>, <option value="classKPIM_1_1ThreadWeaver_1_1Job.html">kpim::threadweaver::job</option>, <option value="classKPIM_1_1ThreadWeaver_1_1Thread.html">kpim::threadweaver::thread</option>, <option value="classKPIM_1_1ThreadWeaver_1_1Weaver.html">kpim::threadweaver::weaver</option>, <option value="classKPIM_1_1ThreadWeaver_1_1WeaverExtension.html">kpim::threadweaver::weaverextension</option>, <option value="classKPIM_1_1ThreadWeaver_1_1WeaverThreadLogger.html">kpim::threadweaver::weaverthreadlogger</option>, <option value="classKPrefsDialog.html">kprefsdialog</option>, <option value="classKPrefsWid.html">kprefswid</option>, <option value="classKPrefsWidBool.html">kprefswidbool</option>, <option value="classKPrefsWidColor.html">kprefswidcolor</option>, <option value="classKPrefsWidCombo.html">kprefswidcombo</option>, <option value="classKPrefsWidDate.html">kprefswiddate</option>, <option value="classKPrefsWidDuration.html">kprefswidduration</option>, <option value="classKPrefsWidFont.html">kprefswidfont</option>, <option value="classKPrefsWidInt.html">kprefswidint</option>, <option value="classKPrefsWidManager.html">kprefswidmanager</option>, <option value="classKPrefsWidPath.html">kprefswidpath</option>, <option value="classKPrefsWidRadios.html">kprefswidradios</option>, <option value="classKPrefsWidString.html">kprefswidstring</option>, <option value="classKPrefsWidTime.html">kprefswidtime</option>, <option value="classKRecentAddress_1_1RecentAddresses.html">krecentaddress::recentaddresses</option>, <option value="classKRegExp3.html">kregexp3</option>, <option value="classKResourcePrefs.html">kresourceprefs</option>, <option value="classKRSqueezedTextLabel.html">krsqueezedtextlabel</option>, <option value="classKSubscription.html">ksubscription</option>, <option value="classKTimeEdit.html">ktimeedit</option>, <option value="classKVCardDrag.html">kvcarddrag</option>, <option value="classKWidgetLister.html">kwidgetlister</option>, <option value="classLinkLocator.html">linklocator</option>, <option value="classQStrictUtf7Codec.html">qstrictutf7codec</option>, <option value="classQUtf7Codec.html">qutf7codec</option>, <option value="classRuleEditWidget.html">ruleeditwidget</option>, <option value="classRuleListWidget.html">rulelistwidget</option>, <option value="classRuleStack.html">rulestack</option>, <option value="classScorableGroup.html">scorablegroup</option>, <option value="classSingleActionWidget.html">singleactionwidget</option>, <option value="classSingleConditionWidget.html">singleconditionwidget</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>
