kmail
KMHeaders Class Reference
#include <kmheaders.h>
Detailed Description
The widget that shows the contents of folders.
Definition at line 48 of file kmheaders.h.
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) |
void | nextMessage () |
void | selectNextMessage () |
void | prevMessage () |
void | selectPrevMessage () |
bool | nextUnreadMessage (bool acceptCurrent=false) |
bool | prevUnreadMessage () |
void | incCurrentMessage () |
void | decCurrentMessage () |
void | selectCurrentMessage () |
void | slotNoDrag () |
void | resetCurrentTime () |
void | reset () |
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 | slotToggleColumn (int id, int mode=-1) |
void | setFolderInfoStatus () |
Signals | |
void | selected (KMMessage *) |
void | activated (KMMessage *) |
void | maybeDeleting () |
void | messageListUpdated () |
void | msgAddedToListView (QListViewItem *) |
Public Member Functions | |
KMHeaders (KMMainWidget *owner, QWidget *parent=0, const char *name=0) | |
virtual | ~KMHeaders () |
virtual void | setFolder (KMFolder *, bool forceJumpToUnread=false) |
KMFolder * | folder (void) |
void | refreshNestedState (void) |
virtual void | setCurrentMsg (int msgId) |
QPtrList< QListViewItem > | currentThread () 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 HeaderItem * | prepareMove (int *contentX, int *contentY) |
virtual void | finalizeMove (HeaderItem *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 KMMessageList * | selectedMsgs (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 KMMessage * | currentMsg () |
virtual HeaderItem * | 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) |
void | highlightCurrentThread () |
bool | eventFilter (QObject *o, QEvent *e) |
const KMMsgBase * | getMsgBaseForItem (const QListViewItem *item) const |
QFont | newFont () const |
QFont | unreadFont () const |
QFont | importantFont () const |
QFont | todoFont () const |
QFont | dateFont () const |
Static Public Member Functions | |
static QString | fancyDate (time_t otime) |
Public Attributes | |
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 (HeaderItem *&, 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 | |
static QPixmap * | pixNew |
static QPixmap * | pixUns |
static QPixmap * | pixDel |
static QPixmap * | pixRead |
static QPixmap * | pixRep |
static QPixmap * | pixSent |
static QPixmap * | pixQueued |
static QPixmap * | pixFwd |
static QPixmap * | pixFlag |
static QPixmap * | pixWatched |
static QPixmap * | pixIgnored |
static QPixmap * | pixSpam |
static QPixmap * | pixHam |
static QPixmap * | pixFullySigned |
static QPixmap * | pixPartiallySigned |
static QPixmap * | pixUndefinedSigned |
static QPixmap * | pixFullyEncrypted |
static QPixmap * | pixPartiallyEncrypted |
static QPixmap * | pixUndefinedEncrypted |
static QPixmap * | pixFiller |
static QPixmap * | pixEncryptionProblematic |
static QPixmap * | pixSignatureProblematic |
static QPixmap * | pixAttachment |
static QPixmap * | pixReadFwd |
static QPixmap * | pixReadReplied |
static QPixmap * | pixReadFwdReplied |
static QPixmap * | pixTodo |
Friends | |
class | ::KMail::HeaderItem |
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 625 of file kmheaders.cpp.
KMFolder* KMHeaders::folder | ( | void | ) | [inline] |
Return the folder whose message headers are being displayed.
Definition at line 65 of file kmheaders.h.
void KMHeaders::refreshNestedState | ( | void | ) |
read the config file and update nested state if necessary
Definition at line 537 of file kmheaders.cpp.
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 1602 of file kmheaders.cpp.
QPtrList< QListViewItem > KMHeaders::currentThread | ( | ) | const |
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 1209 of file kmheaders.cpp.
void KMHeaders::setMsgStatus | ( | KMMsgStatus | status, | |
bool | toggle = false | |||
) | [virtual] |
The following methods processes all selected messages.
Definition at line 1155 of file kmheaders.cpp.
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 1497 of file kmheaders.cpp.
Messages are duplicated and added to given folder.
If aMsg is set this one will be written to the destination folder.
Definition at line 1584 of file kmheaders.cpp.
void KMHeaders::clearSelectableAndAboutToBeDeleted | ( | Q_UINT32 | serNum | ) | [virtual] |
Resets toBeDeleted and selectable status of all selected items.
Definition at line 1648 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 1665 of file kmheaders.cpp.
QValueList< int > KMHeaders::selectedItems | ( | ) |
Returns the index values of currently selected items.
Definition at line 1686 of file kmheaders.cpp.
int KMHeaders::indexOfGetMsg | ( | void | ) | const [inline] |
Returns index of message returned by last getMsg() call.
Definition at line 114 of file kmheaders.h.
KMMainWidget* KMHeaders::owner | ( | void | ) | const [inline] |
const KPaintInfo* KMHeaders::paintInfo | ( | void | ) | const [inline] |
void KMHeaders::readConfig | ( | void | ) | [virtual] |
void KMHeaders::readColorConfig | ( | void | ) | [virtual] |
KMMessage * KMHeaders::currentMsg | ( | ) | [virtual] |
HeaderItem * KMHeaders::currentHeaderItem | ( | ) | [virtual] |
int KMHeaders::currentItemIndex | ( | ) | [virtual] |
Return the index of the message corresponding to the current item.
Definition at line 2379 of file kmheaders.cpp.
void KMHeaders::setCurrentItemByIndex | ( | int | msgIdx | ) | [virtual] |
Set the current item to the one corresponding to the given msg id.
Definition at line 2389 of file kmheaders.cpp.
void KMHeaders::setCurrentItemBySerialNum | ( | unsigned long | serialNum | ) |
Set the current item to the one corresponding to the given serial number (slow!).
Definition at line 3313 of file kmheaders.cpp.
int KMHeaders::topItemIndex | ( | ) | [virtual] |
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 2413 of file kmheaders.cpp.
void KMHeaders::setOpen | ( | QListViewItem * | , | |
bool | ||||
) | [virtual] |
bool KMHeaders::isThreaded | ( | ) | const [inline] |
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 1858 of file kmheaders.cpp.
static 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 2452 of file kmheaders.cpp.
void KMHeaders::selected | ( | KMMessage * | ) | [signal] |
emitted when the list view item corresponding to this message has been selected
void KMHeaders::activated | ( | KMMessage * | ) | [signal] |
emitted when the list view item corresponding to this message has been double clicked
void KMHeaders::maybeDeleting | ( | ) | [signal] |
emitted when we might be about to delete messages
void KMHeaders::messageListUpdated | ( | ) | [signal] |
emitted when the list of messages has been completely rebuilt
void KMHeaders::msgAddedToListView | ( | QListViewItem * | ) | [signal] |
emitted after a new item has been fully built and added to the list view.
We can't use KListView::itemAdded, as that is emitted from the ctor of the item, at which point the building of the item is not yet far enough along to update the quick search, which is what is connected to this signal.
void KMHeaders::selectMessage | ( | QListViewItem * | ) | [slot] |
void KMHeaders::highlightMessage | ( | QListViewItem * | ) | [slot] |
void KMHeaders::slotRMB | ( | ) | [slot] |
void KMHeaders::msgHeaderChanged | ( | KMFolder * | folder, | |
int | msgId | |||
) | [slot] |
Refresh list view item corresponding to the messae with the given id.
Definition at line 1143 of file kmheaders.cpp.
void KMHeaders::msgChanged | ( | ) | [slot] |
For when the list of messages in a folder has changed.
Definition at line 759 of file kmheaders.cpp.
void KMHeaders::folderCleared | ( | ) | [slot] |
void KMHeaders::msgAdded | ( | int | ) | [slot] |
For when the message with the given message id has been added to a folder.
Definition at line 828 of file kmheaders.cpp.
void KMHeaders::msgRemoved | ( | int | , | |
QString | ||||
) | [slot] |
For when the message with the given id has been removed for a folder.
Definition at line 1014 of file kmheaders.cpp.
void KMHeaders::nextMessage | ( | ) | [slot] |
void KMHeaders::selectNextMessage | ( | ) | [slot] |
Same as nextMessage() but don't clear the current selection.
Definition at line 1726 of file kmheaders.cpp.
void KMHeaders::prevMessage | ( | ) | [slot] |
Make the previous header visible scrolling if necessary.
Definition at line 1748 of file kmheaders.cpp.
void KMHeaders::selectPrevMessage | ( | ) | [slot] |
Same as prevMessage() but don't clear the current selection.
Definition at line 1760 of file kmheaders.cpp.
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 1935 of file kmheaders.cpp.
bool KMHeaders::prevUnreadMessage | ( | ) | [slot] |
Make the previous message header visible scrolling if necessary, returning true if an unread message is found.
Definition at line 1961 of file kmheaders.cpp.
void KMHeaders::incCurrentMessage | ( | ) | [slot] |
void KMHeaders::decCurrentMessage | ( | ) | [slot] |
void KMHeaders::selectCurrentMessage | ( | ) | [slot] |
Select the message which currently has focus, if it's not already selected.
Definition at line 1812 of file kmheaders.cpp.
void KMHeaders::slotNoDrag | ( | ) | [slot] |
void KMHeaders::resetCurrentTime | ( | ) | [slot] |
void KMHeaders::reset | ( | ) | [slot] |
void KMHeaders::slotExpandOrCollapseThread | ( | bool | expand | ) | [slot] |
Expands (expand
== true) or collapses (expand
== false) the current thread.
Definition at line 1251 of file kmheaders.cpp.
void KMHeaders::slotExpandOrCollapseAllThreads | ( | bool | expand | ) | [slot] |
Expands (expand
== true) or collapses (expand
== false) all threads.
Definition at line 1268 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 1617 of file kmheaders.cpp.
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 1637 of file kmheaders.cpp.
void KMHeaders::slotToggleColumn | ( | int | id, | |
int | mode = -1 | |||
) | [slot] |
switch a column with the given id (see KPaintInfo enum) 1 for activate, 0 for deactivate, -1 for toggle
Definition at line 249 of file kmheaders.cpp.
void KMHeaders::setFolderInfoStatus | ( | ) | [slot] |
Provide information about number of messages in a folder.
Definition at line 1315 of file kmheaders.cpp.
bool KMHeaders::event | ( | QEvent * | e | ) | [protected, virtual] |
void KMHeaders::paintEmptyArea | ( | QPainter * | p, | |
const QRect & | rect | |||
) | [protected, virtual] |
void KMHeaders::makeHeaderVisible | ( | ) | [protected] |
void KMHeaders::findUnreadAux | ( | HeaderItem *& | , | |
bool & | , | |||
bool | , | |||
bool | ||||
) | [protected] |
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 1701 of file kmheaders.cpp.
void KMHeaders::readFolderConfig | ( | void | ) | [protected, virtual] |
void KMHeaders::writeFolderConfig | ( | void | ) | [protected, virtual] |
void KMHeaders::writeConfig | ( | void | ) | [protected, virtual] |
void KMHeaders::contentsMousePressEvent | ( | QMouseEvent * | ) | [protected, virtual] |
void KMHeaders::setSorting | ( | int | column, | |
bool | ascending = true | |||
) | [protected, virtual] |
void KMHeaders::contentsMouseMoveEvent | ( | QMouseEvent * | e | ) | [protected] |
void KMHeaders::styleChange | ( | QStyle & | oldStyle | ) | [protected] |
reimplemented in order to update the frame width in case of a changed GUI style
Definition at line 1308 of file kmheaders.cpp.
void KMHeaders::setStyleDependantFrameWidth | ( | ) | [protected] |
Set the width of the frame to a reasonable value for the current GUI style.
Definition at line 1293 of file kmheaders.cpp.
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 1442 of file kmheaders.cpp.
void KMHeaders::copySelectedToFolder | ( | int | menuId | ) | [protected, virtual, slot] |
int KMHeaders::slotFilterMsg | ( | KMMessage * | ) | [protected, virtual, slot] |
void KMHeaders::dirtySortOrder | ( | int | ) | [protected, slot] |
void KMHeaders::rightButtonPressed | ( | QListViewItem * | , | |
const QPoint & | , | |||
int | ||||
) | [protected, slot] |
The documentation for this class was generated from the following files: