kmail

KMFolderMgr Class Reference

Inherits QObject.

List of all members.


Detailed Description

Definition at line 16 of file kmfoldermgr.h.


Public Slots

void compactAll ()
void expireAll ()
void removeFolderAux (KMFolder *obsoleteFolder, bool success)
void slotRenameDone (QString newName, bool success)

Signals

void changed ()
void folderRemoved (KMFolder *)
void folderAdded (KMFolder *)
void folderInvalidated (KMFolder *)
void msgAdded (KMFolder *, Q_UINT32)
void msgRemoved (KMFolder *, Q_UINT32)
void msgChanged (KMFolder *, Q_UINT32, int delta)
void msgHeaderChanged (KMFolder *, int idx)
void folderMoveOrCopyOperationFinished ()

Public Member Functions

 KMFolderMgr (const QString &basePath, KMFolderDirType dirType=KMStandardDir)
virtual ~KMFolderMgr ()
QString basePath () const
virtual void setBasePath (const QString &)
KMFolderRootDirdir ()
virtual KMFolderfind (const QString &folderName, bool foldersOnly=TRUE)
virtual KMFolderfindIdString (const QString &folderId, const uint id=0, KMFolderDir *dir=0)
virtual KMFolderfindOrCreate (const QString &folderName, bool sysFldr=TRUE, const uint id=0)
virtual KMFolderfindById (const uint id)
virtual void getFolderURLS (QStringList &flist, const QString &prefix=QString::null, KMFolderDir *adir=0)
virtual KMFoldergetFolderByURL (const QString &vpath, const QString &prefix=QString::null, KMFolderDir *adir=0)
virtual KMFoldercreateFolder (const QString &fName, bool sysFldr=FALSE, KMFolderType aFolderType=KMFolderTypeMbox, KMFolderDir *aFolderDir=0)
virtual void remove (KMFolder *obsoleteFolder)
virtual void contentsChanged (void)
virtual void reload (void)
virtual void createFolderList (QStringList *str, QValueList< QGuardedPtr< KMFolder > > *folders)
virtual void createFolderList (QStringList *str, QValueList< QGuardedPtr< KMFolder > > *folders, KMFolderDir *adir, const QString &prefix, bool i18nized=FALSE)
virtual void createI18nFolderList (QStringList *str, QValueList< QGuardedPtr< KMFolder > > *folders)
void syncAllFolders (KMFolderDir *adir=0)
void compactAllFolders (bool immediate, KMFolderDir *adir=0)
void expireAllFolders (bool immediate, KMFolderDir *adir=0)
void quiet (bool)
int folderCount (KMFolderDir *dir=0)
void tryReleasingFolder (KMFolder *folder, KMFolderDir *Dir=0)
uint createId ()
void moveFolder (KMFolder *folder, KMFolderDir *newParent)
void renameFolder (KMFolder *folder, const QString &newName, KMFolderDir *newParent=0)
void copyFolder (KMFolder *folder, KMFolderDir *newParent)
KMFolderparentFolder (KMFolder *folder)

Protected Member Functions

void removeFolder (KMFolder *aFolder)
void removeDirAux (KMFolderDir *aFolderDir)

Protected Attributes

QString mBasePath
KMFolderRootDir mDir
int mQuiet
bool mChanged
KMFoldermRemoveOrig

Member Function Documentation

QString KMFolderMgr::basePath (  )  const [inline]

Returns path to directory where all the folders live.

Definition at line 25 of file kmfoldermgr.h.

void KMFolderMgr::setBasePath ( const QString &  aBasePath  )  [virtual]

Set base path.

Also calls reload() on the base directory.

Definition at line 128 of file kmfoldermgr.cpp.

KMFolderRootDir & KMFolderMgr::dir ( void   ) 

Provides access to base directory.

Definition at line 428 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::find ( const QString &  folderName,
bool  foldersOnly = TRUE 
) [virtual]

Searches folder and returns it.

Skips directories (objects of type KMFolderDir) if foldersOnly is TRUE.

Definition at line 222 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::findIdString ( const QString &  folderId,
const uint  id = 0,
KMFolderDir dir = 0 
) [virtual]

Searches for a folder with the given id, recurses into directories.

Definition at line 241 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::findOrCreate ( const QString &  folderName,
bool  sysFldr = TRUE,
const uint  id = 0 
) [virtual]

Uses find() to find given folder.

If not found the folder is created. Directories are skipped. If an id is passed this searches for it

Definition at line 301 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::findById ( const uint  id  )  [virtual]

Searches folder by id and returns it.

Skips directories (objects of type KMFolderDir)

Definition at line 235 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::createFolder ( const QString &  fName,
bool  sysFldr = FALSE,
KMFolderType  aFolderType = KMFolderTypeMbox,
KMFolderDir aFolderDir = 0 
) [virtual]

Create a mail folder in the root folder directory dir() with given name.

Returns Folder on success.

Definition at line 177 of file kmfoldermgr.cpp.

void KMFolderMgr::remove ( KMFolder obsoleteFolder  )  [virtual]

Physically remove given folder and delete the given folder object.

Definition at line 340 of file kmfoldermgr.cpp.

void KMFolderMgr::contentsChanged ( void   )  [virtual]

emits changed() signal

Definition at line 435 of file kmfoldermgr.cpp.

void KMFolderMgr::reload ( void   )  [virtual]

Reloads all folders, discarding the existing ones.

Definition at line 443 of file kmfoldermgr.cpp.

void KMFolderMgr::createFolderList ( QStringList *  str,
QValueList< QGuardedPtr< KMFolder > > *  folders 
) [virtual]

Create a list of formatted formatted folder labels and corresponding folders.

Definition at line 448 of file kmfoldermgr.cpp.

void KMFolderMgr::createFolderList ( QStringList *  str,
QValueList< QGuardedPtr< KMFolder > > *  folders,
KMFolderDir adir,
const QString &  prefix,
bool  i18nized = FALSE 
) [virtual]

Auxillary function to facilitate creating a list of formatted folder names, suitable for showing in QComboBox.

Definition at line 462 of file kmfoldermgr.cpp.

void KMFolderMgr::createI18nFolderList ( QStringList *  str,
QValueList< QGuardedPtr< KMFolder > > *  folders 
) [virtual]

Create a list of formatted formatted folder labels and corresponding folders.

The system folder names are translated

Definition at line 455 of file kmfoldermgr.cpp.

void KMFolderMgr::syncAllFolders ( KMFolderDir adir = 0  ) 

fsync all open folders to disk

Definition at line 485 of file kmfoldermgr.cpp.

void KMFolderMgr::compactAllFolders ( bool  immediate,
KMFolderDir adir = 0 
)

Compact all folders that need to be, either immediately or scheduled as a background task.

Definition at line 111 of file kmfoldermgr.cpp.

void KMFolderMgr::expireAllFolders ( bool  immediate,
KMFolderDir adir = 0 
)

Expire old messages in all folders, either immediately or scheduled as a background task.

Check each folder in turn to see if it is configured to AutoExpire.

If so, expire old messages.

Should be called with 0 first time around.

Definition at line 507 of file kmfoldermgr.cpp.

void KMFolderMgr::quiet ( bool  beQuiet  ) 

Enable, disable changed() signals.

Definition at line 523 of file kmfoldermgr.cpp.

int KMFolderMgr::folderCount ( KMFolderDir dir = 0  ) 

Number of folders for purpose of progres report.

Definition at line 91 of file kmfoldermgr.cpp.

void KMFolderMgr::tryReleasingFolder ( KMFolder folder,
KMFolderDir Dir = 0 
)

Try closing folder if possible, something is attempting an exclusive access to it.

Currently used for KMFolderSearch and the background tasks like expiry

Definition at line 539 of file kmfoldermgr.cpp.

uint KMFolderMgr::createId (  ) 

Create a new unique ID.

Definition at line 554 of file kmfoldermgr.cpp.

void KMFolderMgr::moveFolder ( KMFolder folder,
KMFolderDir newParent 
)

Move a folder.

Definition at line 566 of file kmfoldermgr.cpp.

void KMFolderMgr::renameFolder ( KMFolder folder,
const QString &  newName,
KMFolderDir newParent = 0 
)

Rename or move a folder.

Definition at line 572 of file kmfoldermgr.cpp.

void KMFolderMgr::copyFolder ( KMFolder folder,
KMFolderDir newParent 
)

Copy a folder.

Definition at line 584 of file kmfoldermgr.cpp.

KMFolder * KMFolderMgr::parentFolder ( KMFolder folder  ) 

Returns the parent Folder for the given folder or 0 on failure.

Definition at line 369 of file kmfoldermgr.cpp.

void KMFolderMgr::compactAll (  )  [inline, slot]

GUI action: compact all folders that need to be compacted.

Definition at line 129 of file kmfoldermgr.h.

void KMFolderMgr::expireAll (  )  [slot]

GUI action: expire all folders configured as such.

Definition at line 61 of file kmfoldermgr.cpp.

void KMFolderMgr::removeFolderAux ( KMFolder obsoleteFolder,
bool  success 
) [slot]

Called from KMFolder::remove when the folderstorage was removed.

Definition at line 385 of file kmfoldermgr.cpp.

void KMFolderMgr::slotRenameDone ( QString  newName,
bool  success 
) [slot]

Called when the renaming of a folder is done.

Definition at line 594 of file kmfoldermgr.cpp.

void KMFolderMgr::changed (  )  [signal]

Emitted when the list of folders has changed.

This signal is a hook where clients like the KMFolderTree tree-view can connect. The signal is meant to be emitted whenever the code using the folder-manager changed things.

void KMFolderMgr::folderRemoved ( KMFolder  )  [signal]

Emitted, when a folder is about to be removed.

void KMFolderMgr::folderAdded ( KMFolder  )  [signal]

Emitted, when a folder has been added.

void KMFolderMgr::folderInvalidated ( KMFolder  )  [signal]

Emitted, when serial numbers for a folder have been invalidated.

void KMFolderMgr::msgAdded ( KMFolder ,
Q_UINT32   
) [signal]

Emitted, when a message has been appended to a folder.

void KMFolderMgr::msgRemoved ( KMFolder ,
Q_UINT32   
) [signal]

Emitted, when a message has been removed from a folder.

void KMFolderMgr::msgChanged ( KMFolder ,
Q_UINT32  ,
int  delta 
) [signal]

Emitted, when the status of a message is changed.

void KMFolderMgr::msgHeaderChanged ( KMFolder ,
int  idx 
) [signal]

Emitted when a field of the header of a specific message changed.

void KMFolderMgr::folderMoveOrCopyOperationFinished (  )  [signal]

Emitted when a folder has been moved or copied.

void KMFolderMgr::removeFolder ( KMFolder aFolder  )  [protected]

Auxillary function to facilitate removal of a folder.

Definition at line 362 of file kmfoldermgr.cpp.

void KMFolderMgr::removeDirAux ( KMFolderDir aFolderDir  )  [protected]

Auxillary function to facilitate removal of a folder directory.

Definition at line 418 of file kmfoldermgr.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys