libkdepim

KPIM Namespace Reference


Detailed Description

KDEPIM classes for drag and drop of mails.

-*- c++ -*- progressdialog.cpp

// Code example for drag and drop enabled widget

void SomeWidget::contentsDropEvent(QDropEvent *e) { if (e->provides(MailListDrag::format())) { MailList mailList; MailListDrag::decode( e, mailList ); ...

Copyright (c) 2004 Till Adam <adam@kde.org>, David Faure <faure@kde.org>

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

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.

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.

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.


Classes

class  SelectionItem
 Internal helper class. More...
class  BroadcastStatus
 Provides a singleton which broadcasts status messages by emitting signals. More...
class  ClickLineEdit
 This class provides a KLineEdit which contains a greyed-out hinting text as long as the user didn't enter any text. More...
class  CollectingProcess
 An output collecting KProcess class. More...
class  ConfigManager
 Class for managing a set of config options. More...
class  DiffAlgoDisplay
 DiffAlgo and DiffAlgoDisplay work together for displaying differences between two PIM objects like contacts, events or todos. More...
class  DistributionList
 Distribution list of email addresses. More...
class  KMailCompletion
 KMailCompletion allows lookup of email addresses by keyword. More...
class  KPixmapRegionSelectorDialog
 A dialog that uses a KPixmapRegionSelectorWidget to allow the user to select a region of an image. More...
class  KPixmapRegionSelectorWidget
 KPixmapRegionSelectorWidget is a widget that shows a picture and provides the user with a friendly way to select a rectangular subregion of the pixmap. More...
class  LdapObject
 This class is internal. More...
class  LdapClient
 This class is internal. More...
struct  LdapResult
 Structure describing one result returned by a LDAP query. More...
class  LdapSearch
 This class is internal. More...
class  OverlayWidget
 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. More...
class  PluginLoader
 A generic plugin loader for when KPart::Plugin is overkill. More...
class  ProgressManager
 The ProgressManager 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. More...
class  ResourceABC
 This class is the implementation of subfolder resources for KABC. More...

Typedefs

typedef QValueList< LdapResultLdapResultList
typedef QMap< QString, QPair
< int, int > > 
CompletionItemsMap
typedef QValueList< QByteArray > LdapAttrValue
typedef QMap< QString,
LdapAttrValue > 
LdapAttrMap
typedef QValueList< MailSummary > MailList
typedef QMap< ProgressItem
*, bool > 
ProgressItemMap

Functions

static void swapItems (CompletionViewItem *one, CompletionViewItem *other)
QColor darker (const QColor &c)
QColor desaturate (const QColor &c)
QColor fixValue (const QColor &c, int newV)
int getValueOf (const QColor &c)
int pointsToPixel (const QPaintDeviceMetrics &metrics, int pointSize)
static void msgDialog (const QString &msg)
KDE_EXPORT QCString kFileToString (const QString &fileName, bool ensureNewline=true, bool withDialogs=true) KDE_EXPORT
KDE_EXPORT bool kBytesToFile (const char *aBuffer, int len, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose) KDE_EXPORT
KDE_EXPORT bool kCStringToFile (const QCString &aBuffer, const QString &aFileName, bool aAskIfExists, bool aBackup, bool aVerbose)
KDE_EXPORT bool kByteArrayToFile (const QByteArray &buffer, const QString &fileName, bool askIfExists=false, bool createBackup=true, bool withDialogs=true) KDE_EXPORT
QString checkAndCorrectPermissionsIfPossible (const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)
bool checkAndCorrectPermissionsIfPossibleWithErrorHandling (QWidget *parent, const QString &toCheck, const bool recursive, const bool wantItReadable, const bool wantItWritable)

Variables

static const char *const quoteFontSizes [] = { "85", "80", "75" }
static KStaticDeleter
< ProgressManager
progressManagerDeleter

Function Documentation

QString KPIM::checkAndCorrectPermissionsIfPossible ( const QString &  toCheck,
const bool  recursive,
const bool  wantItReadable,
const bool  wantItWritable 
)

Checks and corrects the permissions of a file or folder, and if requested all files and folders below.

It gives back a list of files which do not have the right permissions. This list can be used to show to the user.

Parameters:
toCheck The file or folder of which the permissions should be checked.
recursive Set to true, it will check the contents of a folder for the permissions recursively. If false only toCheck will be checked.
wantItReadable Set to true, it will check for read permissions. If the read permissions are not available, there will be a attempt to correct this.
wantItWritable Set to true, it will check for write permissions. If the write permissions are not available, there will be a attempt to correct this.
Returns:
It will return a string with all files and folders which do not have the right permissions. If empty, then all permissions are ok.

Definition at line 271 of file kfileio.cpp.

bool KPIM::checkAndCorrectPermissionsIfPossibleWithErrorHandling ( QWidget *  parent,
const QString &  toCheck,
const bool  recursive,
const bool  wantItReadable,
const bool  wantItWritable 
)

Checks and corrects the permissions of a file or folder, and if requested all files and folders below.

If the permissions are not ok, it tries to correct them. If that fails then a warning with detailled information is given.

Parameters:
parent 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.
toCheck The file or folder of which the permissions should be checked.
recursive Set to true, it will check the contents of a folder for the permissions recursively. If false only toCheck will be checked.
wantItReadable Set to true, it will check for read permissions. If the read permissions are not available, there will be a attempt to correct this.
wantItWritable Set to true, it will check for write permissions. If the write permissions are not available, there will be a attempt to correct this.
Returns:
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.

Definition at line 368 of file kfileio.cpp.

KDE_EXPORT bool KPIM::kByteArrayToFile ( const QByteArray &  aBuffer,
const QString &  aFileName,
bool  aAskIfExists,
bool  aBackup,
bool  aVerbose 
)

Does not stop at NUL.

Definition at line 263 of file kfileio.cpp.

bool KPIM::kBytesToFile ( const char *  aBuffer,
int  len,
const QString &  aFileName,
bool  aAskIfExists,
bool  aBackup,
bool  aVerbose 
)

Save a file.

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.

Definition at line 176 of file kfileio.cpp.

QCString KPIM::kFileToString ( const QString &  fileName,
bool  ensureNewline = true,
bool  withDialogs = true 
)

Load a file.

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.

Definition at line 36 of file kfileio.cpp.

KDE Home | KDE Accessibility Home | Description of Access Keys