kmail Library API Documentation

KMHeaders Class Reference

The widget that shows the contents of folders. More...

#include <kmheaders.h>

List of all members.

Public Slots

void selectMessage (QListViewItem *)
void highlightMessage (QListViewItem *)
void slotRMB ()
void msgHeaderChanged (KMFolder *folder, int msgId)
void msgChanged ()
void folderCleared ()
void msgAdded (int)
void msgRemoved (int, QString, QString)
void nextMessage ()
void selectNextMessage ()
void prevMessage ()
void selectPrevMessage ()
bool nextUnreadMessage (bool acceptCurrent=false)
bool prevUnreadMessage ()
void slotNoDrag ()
void resetCurrentTime ()
void slotExpandOrCollapseThread (bool expand)
void slotExpandOrCollapseAllThreads (bool expand)
virtual void ensureCurrentItemVisible ()
virtual void setSelected (QListViewItem *item, bool selected)
void setSelectedByIndex (QValueList< int > items, bool selected)
void slotToggleSizeColumn (int mode=-1)
void setFolderInfoStatus ()

Signals

virtual void selected (KMMessage *)
virtual void activated (KMMessage *)
virtual void maybeDeleting ()
virtual void messageListUpdated ()

Public Member Functions

 KMHeaders (KMMainWidget *owner, QWidget *parent=0, const char *name=0)
virtual void setFolder (KMFolder *, bool forceJumpToUnread=false)
KMFolderfolder (void)
void refreshNestedState (void)
virtual void setCurrentMsg (int msgId)
QPtrList< QListViewItemcurrentThread () const
virtual void setThreadStatus (KMMsgStatus status, bool toggle=false)
virtual void setMsgRead (int msgId)
virtual void setMsgStatus (KMMsgStatus status, bool toggle=false)
virtual void deleteMsg ()
virtual void applyFiltersOnMsg ()
virtual void undo ()
virtual bool canUndo () const
virtual KMHeaderItem * prepareMove (int *contentX, int *contentY)
virtual void finalizeMove (KMHeaderItem *item, int contentX, int contentY)
virtual void moveMsgToFolder (KMFolder *destination, bool askForConfirmation=true)
virtual void copyMsgToFolder (KMFolder *destination, KMMessage *aMsg=0)
virtual void clearSelectableAndAboutToBeDeleted (Q_UINT32 serNum)
virtual KMMessageListselectedMsgs (bool toBeDeleted=false)
QValueList< int > selectedItems ()
int indexOfGetMsg (void) const
KMMainWidget * owner (void) const
const KPaintInfo * paintInfo (void) const
virtual void readConfig (void)
virtual void readColorConfig (void)
virtual void reset (void)
void showNewMail ()
virtual KMMessage * currentMsg ()
virtual KMHeaderItem * currentHeaderItem ()
virtual int currentItemIndex ()
virtual void setCurrentItemByIndex (int msgIdx)
void setCurrentItemBySerialNum (unsigned long serialNum)
virtual int topItemIndex ()
virtual void setTopItemByIndex (int aMsgIdx)
virtual void setNestedOverride (bool override)
virtual void setSubjectThreading (bool subjThreading)
virtual void setOpen (QListViewItem *, bool)
NestingPolicy getNestingPolicy () const
bool isThreaded () const
virtual int findUnread (bool findNext, int startAt=-1, bool onlyNew=false, bool acceptCurrent=false)
void highlightMessage (QListViewItem *, bool markitread)
bool eventFilter (QObject *o, QEvent *e)
const KMMsgBase * getMsgBaseForItem (const QListViewItem *item) const

Static Public Member Functions

QString fancyDate (time_t otime)

Public Attributes

QFont dateFont
bool noRepaint

Protected Slots

virtual void moveSelectedToFolder (int menuId)
virtual void copySelectedToFolder (int menuId)
virtual int slotFilterMsg (KMMessage *)
void dirtySortOrder (int)
void rightButtonPressed (QListViewItem *, const QPoint &, int)

Protected Member Functions

virtual bool event (QEvent *e)
virtual void paintEmptyArea (QPainter *p, const QRect &rect)
void makeHeaderVisible ()
void findUnreadAux (KMHeaderItem *&, bool &, bool, bool)
virtual int firstSelectedMsg () const
virtual void readFolderConfig (void)
virtual void writeFolderConfig (void)
virtual void writeConfig (void)
virtual void contentsMousePressEvent (QMouseEvent *)
virtual void contentsMouseReleaseEvent (QMouseEvent *e)
virtual void keyPressEvent (QKeyEvent *e)
virtual void setSorting (int column, bool ascending=true)
void contentsMouseMoveEvent (QMouseEvent *e)
void styleChange (QStyle &oldStyle)
void setStyleDependantFrameWidth ()

Static Protected Attributes

QPixmappixNew = 0
QPixmappixUns = 0
QPixmappixDel = 0
QPixmappixRead = 0
QPixmappixRep = 0
QPixmappixSent = 0
QPixmappixQueued = 0
QPixmappixFwd = 0
QPixmappixFlag = 0
QPixmappixWatched = 0
QPixmappixIgnored = 0
QPixmappixSpam = 0
QPixmappixHam = 0
QPixmappixFullySigned = 0
QPixmappixPartiallySigned = 0
QPixmappixUndefinedSigned = 0
QPixmappixFullyEncrypted = 0
QPixmappixPartiallyEncrypted = 0
QPixmappixUndefinedEncrypted = 0
QPixmappixFiller
QPixmappixEncryptionProblematic = 0
QPixmappixSignatureProblematic = 0
QPixmappixAttachment = 0


Detailed Description

The widget that shows the contents of folders.

Definition at line 38 of file kmheaders.h.


Member Function Documentation

void KMHeaders::setFolder KMFolder ,
bool  forceJumpToUnread = false
[virtual]
 

A new folder has been selected update the list of headers shown To override the global settings for jumping to the first unread msg use forceJumpToUnread.

Definition at line 888 of file kmheaders.cpp.

References currentItemIndex(), folderCleared(), isThreaded(), makeHeaderVisible(), msgAdded(), msgChanged(), msgHeaderChanged(), msgRemoved(), readFolderConfig(), setCurrentMsg(), setFolder(), setFolderInfoStatus(), setTopItemByIndex(), topItemIndex(), and writeFolderConfig().

Referenced by setFolder().

KMFolder* KMHeaders::folder void   )  [inline]
 

Return the folder whose message headers are being displayed.

Definition at line 55 of file kmheaders.h.

void KMHeaders::refreshNestedState void   ) 
 

read the config file and update nested state if necessary

Definition at line 809 of file kmheaders.cpp.

References isThreaded(), and reset().

void KMHeaders::setCurrentMsg int  msgId  )  [virtual]
 

Set current message.

If id<0 then the first message is shown, if id>count() the last message is shown.

Definition at line 1827 of file kmheaders.cpp.

References makeHeaderVisible(), setCurrentMsg(), setFolderInfoStatus(), and setSelected().

Referenced by msgChanged(), nextUnreadMessage(), prevUnreadMessage(), reset(), setCurrentMsg(), setFolder(), and slotExpandOrCollapseThread().

QPtrList< QListViewItem > KMHeaders::currentThread  )  const
 

Get a list of all items in the current thread.

Definition at line 1397 of file kmheaders.cpp.

void KMHeaders::setThreadStatus KMMsgStatus  status,
bool  toggle = false
[virtual]
 

Set all messages in the current thread to status status or toggle it, if specified.

Definition at line 1419 of file kmheaders.cpp.

void KMHeaders::setMsgStatus KMMsgStatus  status,
bool  toggle = false
[virtual]
 

The following methods processes all selected messages.

Definition at line 1380 of file kmheaders.cpp.

References setMsgStatus().

Referenced by setMsgStatus().

void KMHeaders::moveMsgToFolder KMFolder destination,
bool  askForConfirmation = true
[virtual]
 

If destination is 0 then the messages are deleted, otherwise they are moved to this folder.

The second parameter is usefull when the user has already confirmed the move/deletion.

Definition at line 1711 of file kmheaders.cpp.

References moveMsgToFolder().

Referenced by moveMsgToFolder(), and moveSelectedToFolder().

void KMHeaders::copyMsgToFolder KMFolder destination,
KMMessage *  aMsg = 0
[virtual]
 

Messages are duplicated and added to given folder.

If aMsg is set this one will be written to the destination folder.

Definition at line 1809 of file kmheaders.cpp.

References copyMsgToFolder().

Referenced by copyMsgToFolder(), and copySelectedToFolder().

void KMHeaders::clearSelectableAndAboutToBeDeleted Q_UINT32  serNum  )  [virtual]
 

Resets toBeDeleted and selectable status of all selected items.

Definition at line 1873 of file kmheaders.cpp.

KMMessageList * KMHeaders::selectedMsgs bool  toBeDeleted = false  )  [virtual]
 

Returns list of selected messages.

Mark the corresponding header items to be deleted, if specified.

Definition at line 1890 of file kmheaders.cpp.

References selectedMsgs().

Referenced by selectedMsgs().

QValueList< int > KMHeaders::selectedItems  ) 
 

Returns the index values of currently selected items.

Definition at line 1909 of file kmheaders.cpp.

Referenced by msgChanged().

int KMHeaders::indexOfGetMsg void   )  const [inline]
 

Returns index of message returned by last getMsg() call.

Definition at line 104 of file kmheaders.h.

KMMainWidget* KMHeaders::owner void   )  const [inline]
 

Returns pointer to owning main window.

Definition at line 107 of file kmheaders.h.

const KPaintInfo* KMHeaders::paintInfo void   )  const [inline]
 

PaintInfo pointer.

Definition at line 110 of file kmheaders.h.

void KMHeaders::readConfig void   )  [virtual]
 

Read config options.

Definition at line 738 of file kmheaders.cpp.

References readColorConfig(), and slotToggleSizeColumn().

void KMHeaders::readColorConfig void   )  [virtual]
 

Read color options and set palette.

Definition at line 699 of file kmheaders.cpp.

Referenced by readConfig().

void KMHeaders::reset void   )  [virtual]
 

Refresh the list of message headers shown.

Definition at line 794 of file kmheaders.cpp.

References currentItemIndex(), setCurrentMsg(), setTopItemByIndex(), and topItemIndex().

Referenced by refreshNestedState().

void KMHeaders::showNewMail  ) 
 

Scroll to show new mail.

Definition at line 2588 of file kmheaders.cpp.

References currentItemIndex(), and setTopItemByIndex().

KMMessage * KMHeaders::currentMsg  )  [virtual]
 

Return the current message.

Definition at line 2537 of file kmheaders.cpp.

References currentHeaderItem().

KMHeaderItem * KMHeaders::currentHeaderItem  )  [virtual]
 

Return the current list view item.

Definition at line 2547 of file kmheaders.cpp.

Referenced by currentItemIndex(), currentMsg(), findUnread(), msgRemoved(), and writeFolderConfig().

int KMHeaders::currentItemIndex  )  [virtual]
 

Return the index of the message corresponding to the current item.

Definition at line 2553 of file kmheaders.cpp.

References currentHeaderItem().

Referenced by msgChanged(), reset(), setFolder(), showNewMail(), and writeFolderConfig().

void KMHeaders::setCurrentItemByIndex int  msgIdx  )  [virtual]
 

Set the current item to the one corresponding to the given msg id.

Definition at line 2563 of file kmheaders.cpp.

References setCurrentItemByIndex(), and setSelected().

Referenced by setCurrentItemByIndex().

void KMHeaders::setCurrentItemBySerialNum unsigned long  serialNum  ) 
 

Set the current item to the one corresponding to the given serial number (slow!).

Definition at line 3453 of file kmheaders.cpp.

References setCurrentItemBySerialNum(), and setSelected().

Referenced by setCurrentItemBySerialNum().

int KMHeaders::topItemIndex  )  [virtual]
 

Return the message id of the top most visible item.

Definition at line 2577 of file kmheaders.cpp.

Referenced by msgChanged(), reset(), setFolder(), and writeFolderConfig().

void KMHeaders::setTopItemByIndex int  aMsgIdx  )  [virtual]
 

Make the item corresponding to the message with the given id the top most visible item.

Definition at line 2601 of file kmheaders.cpp.

References setTopItemByIndex().

Referenced by msgChanged(), reset(), setFolder(), setTopItemByIndex(), and showNewMail().

void KMHeaders::setOpen QListViewItem ,
bool 
[virtual]
 

Double force items to always be open.

Definition at line 2635 of file kmheaders.cpp.

References setOpen().

Referenced by setOpen().

bool KMHeaders::isThreaded  )  const [inline]
 

Returns true if the current header list is threaded.

Definition at line 146 of file kmheaders.h.

Referenced by msgAdded(), msgRemoved(), readFolderConfig(), refreshNestedState(), setFolder(), setSelected(), and slotExpandOrCollapseThread().

int KMHeaders::findUnread bool  findNext,
int  startAt = -1,
bool  onlyNew = false,
bool  acceptCurrent = false
[virtual]
 

Find next/prev unread message.

Starts at currentItem() if startAt is unset.

Definition at line 2045 of file kmheaders.cpp.

References currentHeaderItem(), findUnread(), and findUnreadAux().

Referenced by findUnread(), nextUnreadMessage(), and prevUnreadMessage().

QString KMHeaders::fancyDate time_t  otime  )  [static]
 

return a string relativ to the current time

const KMMsgBase * KMHeaders::getMsgBaseForItem const QListViewItem item  )  const
 

gets the message represented by the item as a KMMsgBase.

Definition at line 2642 of file kmheaders.cpp.

References getMsgBaseForItem().

Referenced by getMsgBaseForItem().

virtual void KMHeaders::selected KMMessage *   )  [virtual, signal]
 

emitted when the list view item corresponding to this message has been selected

Referenced by msgChanged().

virtual void KMHeaders::activated KMMessage *   )  [virtual, signal]
 

emitted when the list view item corresponding to this message has been double clicked

Referenced by selectMessage().

virtual void KMHeaders::maybeDeleting  )  [virtual, signal]
 

emitted when we might be about to delete messages

Referenced by msgChanged(), and msgRemoved().

virtual void KMHeaders::messageListUpdated  )  [virtual, signal]
 

emitted when the list of messages has been completely rebuilt

Referenced by msgAdded().

void KMHeaders::selectMessage QListViewItem  )  [slot]
 

For when a list view item has been double clicked.

Definition at line 2234 of file kmheaders.cpp.

References activated(), and selectMessage().

Referenced by selectMessage().

void KMHeaders::highlightMessage QListViewItem  )  [slot]
 

For when a list view item has been selected.

Definition at line 2456 of file kmheaders.cpp.

void KMHeaders::slotRMB  )  [slot]
 

For when righ mouse button is pressed.

Definition at line 2462 of file kmheaders.cpp.

Referenced by rightButtonPressed().

void KMHeaders::msgHeaderChanged KMFolder folder,
int  msgId
[slot]
 

Refresh list view item corresponding to the messae with the given id.

Definition at line 1368 of file kmheaders.cpp.

References msgHeaderChanged().

Referenced by msgAdded(), msgHeaderChanged(), and setFolder().

void KMHeaders::msgChanged  )  [slot]
 

For when the list of messages in a folder has changed.

Definition at line 1019 of file kmheaders.cpp.

References currentItemIndex(), maybeDeleting(), selected(), selectedItems(), setCurrentMsg(), setSelectedByIndex(), setTopItemByIndex(), and topItemIndex().

Referenced by setFolder().

void KMHeaders::folderCleared  )  [slot]
 

For when the folder has been cleared.

Definition at line 2720 of file kmheaders.cpp.

Referenced by msgRemoved(), and setFolder().

void KMHeaders::msgAdded int   )  [slot]
 

For when the message with the given message id has been added to a folder.

Definition at line 1074 of file kmheaders.cpp.

References dirtySortOrder(), isThreaded(), makeHeaderVisible(), messageListUpdated(), msgAdded(), msgHeaderChanged(), and setSelected().

Referenced by msgAdded(), and setFolder().

void KMHeaders::msgRemoved int  ,
QString  ,
QString 
[slot]
 

For when the message with the given id has been removed for a folder.

Definition at line 1259 of file kmheaders.cpp.

References currentHeaderItem(), dirtySortOrder(), folderCleared(), isThreaded(), maybeDeleting(), and msgRemoved().

Referenced by msgRemoved(), and setFolder().

void KMHeaders::nextMessage  )  [slot]
 

Make the next header visible scrolling if necessary.

Definition at line 1937 of file kmheaders.cpp.

References selectNextMessage(), and setSelected().

void KMHeaders::selectNextMessage  )  [slot]
 

Same as nextMessage() but don't clear the current selection.

Definition at line 1949 of file kmheaders.cpp.

Referenced by nextMessage().

void KMHeaders::prevMessage  )  [slot]
 

Make the previous header visible scrolling if necessary.

Definition at line 1971 of file kmheaders.cpp.

References selectPrevMessage(), and setSelected().

void KMHeaders::selectPrevMessage  )  [slot]
 

Same as prevMessage() but don't clear the current selection.

Definition at line 1983 of file kmheaders.cpp.

Referenced by prevMessage().

bool KMHeaders::nextUnreadMessage bool  acceptCurrent = false  )  [slot]
 

Make the nextUnread message header visible scrolling if necessary, returning true if an unread message is found.

Definition at line 2122 of file kmheaders.cpp.

References findUnread(), nextUnreadMessage(), and setCurrentMsg().

Referenced by nextUnreadMessage().

bool KMHeaders::prevUnreadMessage  )  [slot]
 

Make the previous message header visible scrolling if necessary, returning true if an unread message is found.

Definition at line 2148 of file kmheaders.cpp.

References findUnread(), and setCurrentMsg().

void KMHeaders::slotNoDrag  )  [slot]
 

Don't show a drag cursor.

Definition at line 2168 of file kmheaders.cpp.

void KMHeaders::resetCurrentTime  )  [slot]
 

timer function to set the current time regularly

Definition at line 2227 of file kmheaders.cpp.

void KMHeaders::slotExpandOrCollapseThread bool  expand  )  [slot]
 

Expands (expand == true) or collapses (expand == false) the current thread.

Definition at line 1460 of file kmheaders.cpp.

References isThreaded(), setCurrentMsg(), and slotExpandOrCollapseThread().

Referenced by slotExpandOrCollapseThread().

void KMHeaders::slotExpandOrCollapseAllThreads bool  expand  )  [slot]
 

Expands (expand == true) or collapses (expand == false) all threads.

Definition at line 1477 of file kmheaders.cpp.

void KMHeaders::setSelected QListViewItem item,
bool  selected
[virtual, slot]
 

Select an item and if it is the parent of a closed thread, also recursively select its children.

Definition at line 1842 of file kmheaders.cpp.

References isThreaded(), and setSelected().

Referenced by contentsMousePressEvent(), msgAdded(), nextMessage(), prevMessage(), rightButtonPressed(), setCurrentItemByIndex(), setCurrentItemBySerialNum(), setCurrentMsg(), and setSelected().

void KMHeaders::setSelectedByIndex QValueList< int >  items,
bool  selected
[slot]
 

Select several items by message index and if they are the parent of a closed thread, also recursively select their children.

Definition at line 1862 of file kmheaders.cpp.

Referenced by msgChanged().

void KMHeaders::slotToggleSizeColumn int  mode = -1  )  [slot]
 

switch size-column 1 for activate, 0 for deactivate, -1 for toggle

Definition at line 653 of file kmheaders.cpp.

References slotToggleSizeColumn(), and writeConfig().

Referenced by readConfig(), and slotToggleSizeColumn().

void KMHeaders::setFolderInfoStatus  )  [slot]
 

Provide information about number of messages in a folder.

Definition at line 1524 of file kmheaders.cpp.

Referenced by setCurrentMsg(), and setFolder().

bool KMHeaders::event QEvent e  )  [protected, virtual]
 

Look for color changes.

Definition at line 687 of file kmheaders.cpp.

void KMHeaders::paintEmptyArea QPainter p,
const QRect rect
[protected, virtual]
 

Overridden to support backing pixmap.

Definition at line 676 of file kmheaders.cpp.

References paintEmptyArea().

Referenced by paintEmptyArea().

void KMHeaders::makeHeaderVisible  )  [protected]
 

Ensure the current item is visible.

Definition at line 2175 of file kmheaders.cpp.

Referenced by msgAdded(), setCurrentMsg(), and setFolder().

void KMHeaders::findUnreadAux KMHeaderItem *&  ,
bool &  ,
bool  ,
bool 
[protected]
 

Auxillary method to findUnread.

Definition at line 2006 of file kmheaders.cpp.

References findUnreadAux().

Referenced by findUnread(), and findUnreadAux().

int KMHeaders::firstSelectedMsg  )  const [protected, virtual]
 

Returns message index of first selected message of the messages where the message with the given id is in.

This for finding the correct message that shall be the current message after move/delete of multiple messages.

Definition at line 1924 of file kmheaders.cpp.

void KMHeaders::readFolderConfig void   )  [protected, virtual]
 

Read per-folder config options and apply them.

Definition at line 828 of file kmheaders.cpp.

References isThreaded().

Referenced by setFolder().

void KMHeaders::writeFolderConfig void   )  [protected, virtual]
 

Write per-folder config options.

Definition at line 858 of file kmheaders.cpp.

References currentHeaderItem(), currentItemIndex(), and topItemIndex().

Referenced by setFolder(), and setSorting().

void KMHeaders::writeConfig void   )  [protected, virtual]
 

Write global config options.

Definition at line 879 of file kmheaders.cpp.

Referenced by slotToggleSizeColumn().

void KMHeaders::contentsMousePressEvent QMouseEvent  )  [protected, virtual]
 

Handle shift and control selection.

Definition at line 2344 of file kmheaders.cpp.

References contentsMousePressEvent(), and setSelected().

Referenced by contentsMousePressEvent().

void KMHeaders::setSorting int  column,
bool  ascending = true
[protected, virtual]
 

Called when a header is clicked.

Definition at line 2649 of file kmheaders.cpp.

References dirtySortOrder(), setSorting(), and writeFolderConfig().

Referenced by setSorting().

void KMHeaders::contentsMouseMoveEvent QMouseEvent e  )  [protected]
 

To initiate a drag operation.

Definition at line 2418 of file kmheaders.cpp.

References contentsMouseMoveEvent().

Referenced by contentsMouseMoveEvent().

void KMHeaders::styleChange QStyle oldStyle  )  [protected]
 

reimplemented in order to update the frame width in case of a changed GUI style

Definition at line 1517 of file kmheaders.cpp.

References setStyleDependantFrameWidth(), and styleChange().

Referenced by styleChange().

void KMHeaders::setStyleDependantFrameWidth  )  [protected]
 

Set the width of the frame to a reasonable value for the current GUI style.

Definition at line 1502 of file kmheaders.cpp.

Referenced by styleChange().

void KMHeaders::moveSelectedToFolder int  menuId  )  [protected, virtual, slot]
 

Move messages corresponding to the selected items to the folder corresponding to the given menuId.

Definition at line 1656 of file kmheaders.cpp.

References moveMsgToFolder(), and moveSelectedToFolder().

Referenced by moveSelectedToFolder().

void KMHeaders::copySelectedToFolder int  menuId  )  [protected, virtual, slot]
 

Same thing but copy.

Definition at line 1801 of file kmheaders.cpp.

References copyMsgToFolder(), and copySelectedToFolder().

Referenced by copySelectedToFolder().

int KMHeaders::slotFilterMsg KMMessage *   )  [protected, virtual, slot]
 

Apply the filter Rules to a single message.

Definition at line 1439 of file kmheaders.cpp.

References slotFilterMsg(), and KMFolder::unGetMsg().

Referenced by slotFilterMsg().

void KMHeaders::dirtySortOrder int   )  [protected, slot]
 

dirties the sort order

Definition at line 2883 of file kmheaders.cpp.

Referenced by msgAdded(), msgRemoved(), and setSorting().

void KMHeaders::rightButtonPressed QListViewItem ,
const QPoint ,
int 
[protected, slot]
 

show context menu

Definition at line 2331 of file kmheaders.cpp.

References rightButtonPressed(), setSelected(), and slotRMB().

Referenced by rightButtonPressed().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kmail Library Version 3.3.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Fri Oct 1 15:19:25 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003