kmail

#include <kmheaders.h>

Inherits TDEListView.

Public Slots

void selectMessage (TQListViewItem *)
 
void highlightMessage (TQListViewItem *)
 
void slotRMB ()
 
void msgHeaderChanged (KMFolder *folder, int msgId)
 
void msgChanged ()
 
void folderCleared ()
 
void folderClosed ()
 
void msgAdded (int)
 
void msgRemoved (int, TQString)
 
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 (TQListViewItem *item, bool selected)
 
void setSelectedByIndex (TQValueList< 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 (TQListViewItem *)
 

Public Member Functions

 KMHeaders (KMMainWidget *owner, TQWidget *parent=0, const char *name=0)
 
virtual void setFolder (KMFolder *, bool forceJumpToUnread=false)
 
KMFolderfolder (void)
 
void refreshNestedState (void)
 
virtual void setCurrentMsg (int msgId)
 
TQPtrList< TQListViewItem > 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 HeaderItemprepareMove (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 (TQ_UINT32 serNum)
 
virtual KMMessageList * selectedMsgs (bool toBeDeleted=false)
 
TQValueList< int > selectedItems ()
 
TQValueList< TQ_UINT32 > selectedSernums ()
 
TQValueList< TQ_UINT32 > selectedVisibleSernums ()
 
int indexOfGetMsg (void) const
 
KMMainWidget * owner (void) const
 
const KPaintInfo * paintInfo (void) const
 
virtual void readConfig (void)
 
virtual void readColorConfig (void)
 
void restoreColumnLayout (TDEConfig *config, const TQString &group)
 
virtual KMMessagecurrentMsg ()
 
virtual HeaderItemcurrentHeaderItem ()
 
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 (TQListViewItem *, bool)
 
NestingPolicy getNestingPolicy () const
 
bool isThreaded () const
 
virtual int findUnread (bool findNext, int startAt=-1, bool onlyNew=false, bool acceptCurrent=false)
 
void highlightMessage (TQListViewItem *, bool markitread)
 
void highlightCurrentThread ()
 
bool eventFilter (TQObject *o, TQEvent *e)
 
const KMMsgBase * getMsgBaseForItem (const TQListViewItem *item) const
 
TQFont newFont () const
 
TQFont unreadFont () const
 
TQFont importantFont () const
 
TQFont todoFont () const
 
TQFont dateFont () const
 
void setCopiedMessages (const TQValueList< TQ_UINT32 > &msgs, bool move)
 
bool isMessageCut (TQ_UINT32 serNum) const
 
virtual void writeConfig (void)
 

Static Public Member Functions

static TQString fancyDate (time_t otime)
 

Public Attributes

bool noRepaint
 
uint ascending: 1
 
uint dirty: 1
 
short column
 
uint fakeSort: 1
 
uint removed: 1
 

Protected Slots

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

Protected Member Functions

virtual bool event (TQEvent *e)
 
virtual void paintEmptyArea (TQPainter *p, const TQRect &rect)
 
void makeHeaderVisible ()
 
void findUnreadAux (HeaderItem *&, bool &, bool, bool)
 
virtual int firstSelectedMsg () const
 
virtual void readFolderConfig (void)
 
virtual void writeFolderConfig (void)
 
virtual void contentsMousePressEvent (TQMouseEvent *)
 
virtual void contentsMouseReleaseEvent (TQMouseEvent *e)
 
virtual void keyPressEvent (TQKeyEvent *e)
 
virtual void setSorting (int column, bool ascending=true)
 
void contentsMouseMoveEvent (TQMouseEvent *e)
 
void styleChange (TQStyle &oldStyle)
 
void setStyleDependantFrameWidth ()
 

Static Protected Attributes

static TQPixmap * pixNew = 0
 
static TQPixmap * pixUns = 0
 
static TQPixmap * pixDel = 0
 
static TQPixmap * pixRead = 0
 
static TQPixmap * pixRep = 0
 
static TQPixmap * pixSent = 0
 
static TQPixmap * pixQueued = 0
 
static TQPixmap * pixFwd = 0
 
static TQPixmap * pixFlag = 0
 
static TQPixmap * pixWatched = 0
 
static TQPixmap * pixIgnored = 0
 
static TQPixmap * pixSpam = 0
 
static TQPixmap * pixHam = 0
 
static TQPixmap * pixFullySigned = 0
 
static TQPixmap * pixPartiallySigned = 0
 
static TQPixmap * pixUndefinedSigned = 0
 
static TQPixmap * pixFullyEncrypted = 0
 
static TQPixmap * pixPartiallyEncrypted = 0
 
static TQPixmap * pixUndefinedEncrypted = 0
 
static TQPixmap * pixFiller
 
static TQPixmap * pixEncryptionProblematic = 0
 
static TQPixmap * pixSignatureProblematic = 0
 
static TQPixmap * pixAttachment = 0
 
static TQPixmap * pixInvitation = 0
 
static TQPixmap * pixReadFwd = 0
 
static TQPixmap * pixReadReplied = 0
 
static TQPixmap * pixReadFwdReplied = 0
 
static TQPixmap * pixTodo = 0
 

Friends

class ::KMail::HeaderItem
 

Detailed Description

The widget that shows the contents of folders.

Definition at line 46 of file kmheaders.h.

Member Function Documentation

◆ activated

void KMHeaders::activated ( KMMessage )
signal

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

◆ clearSelectableAndAboutToBeDeleted()

void KMHeaders::clearSelectableAndAboutToBeDeleted ( TQ_UINT32  serNum)
virtual

Resets toBeDeleted and selectable status of all selected items.

Definition at line 1738 of file kmheaders.cpp.

◆ contentsMouseMoveEvent()

void KMHeaders::contentsMouseMoveEvent ( TQMouseEvent *  e)
protected

To initiate a drag operation.

Definition at line 2375 of file kmheaders.cpp.

◆ contentsMousePressEvent()

void KMHeaders::contentsMousePressEvent ( TQMouseEvent *  e)
protectedvirtual

Handle shift and control selection.

Definition at line 2276 of file kmheaders.cpp.

◆ copyMsgToFolder()

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 1674 of file kmheaders.cpp.

◆ copySelectedToFolder

void KMHeaders::copySelectedToFolder ( int  menuId)
protectedvirtualslot

Same thing but copy.

Definition at line 1666 of file kmheaders.cpp.

◆ currentHeaderItem()

HeaderItem * KMHeaders::currentHeaderItem ( )
virtual

Return the current list view item.

Definition at line 2527 of file kmheaders.cpp.

◆ currentItemIndex()

int KMHeaders::currentItemIndex ( )
virtual

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

Definition at line 2533 of file kmheaders.cpp.

◆ currentMsg()

KMMessage * KMHeaders::currentMsg ( )
virtual

Return the current message.

Definition at line 2517 of file kmheaders.cpp.

◆ currentThread()

TQPtrList< TQListViewItem > KMHeaders::currentThread ( ) const

Get a list of all items in the current thread.

Definition at line 1234 of file kmheaders.cpp.

◆ decCurrentMessage

void KMHeaders::decCurrentMessage ( )
slot

Focus the previous message, but don't select it.

Definition at line 1897 of file kmheaders.cpp.

◆ dirtySortOrder

void KMHeaders::dirtySortOrder ( int  column)
protectedslot

dirties the sort order

Definition at line 2865 of file kmheaders.cpp.

◆ event()

bool KMHeaders::event ( TQEvent *  e)
protectedvirtual

Look for color changes.

Definition at line 414 of file kmheaders.cpp.

◆ fancyDate()

static TQString KMHeaders::fancyDate ( time_t  otime)
static

return a string relativ to the current time

◆ findUnread()

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 1960 of file kmheaders.cpp.

◆ findUnreadAux()

void KMHeaders::findUnreadAux ( HeaderItem *&  item,
bool &  foundUnreadMessage,
bool  onlyNew,
bool  aDirNext 
)
protected

Auxillary method to findUnread.

Definition at line 1921 of file kmheaders.cpp.

◆ firstSelectedMsg()

int KMHeaders::firstSelectedMsg ( ) const
protectedvirtual

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 1791 of file kmheaders.cpp.

◆ folder()

KMFolder* KMHeaders::folder ( void  )
inline

Return the folder whose message headers are being displayed.

Definition at line 64 of file kmheaders.h.

◆ folderCleared

void KMHeaders::folderCleared ( )
slot

For when the folder has been cleared.

Definition at line 2691 of file kmheaders.cpp.

◆ folderClosed

void KMHeaders::folderClosed ( )
slot

For when the folder has been cleared.

Definition at line 2701 of file kmheaders.cpp.

◆ getMsgBaseForItem()

const KMMsgBase * KMHeaders::getMsgBaseForItem ( const TQListViewItem *  item) const

gets the message represented by the item as a KMMsgBase.

Definition at line 2609 of file kmheaders.cpp.

◆ highlightMessage

void KMHeaders::highlightMessage ( TQListViewItem *  i)
slot

For when a list view item has been selected.

Definition at line 2418 of file kmheaders.cpp.

◆ incCurrentMessage

void KMHeaders::incCurrentMessage ( )
slot

Focus the next message, but don't select it.

Definition at line 1879 of file kmheaders.cpp.

◆ indexOfGetMsg()

int KMHeaders::indexOfGetMsg ( void  ) const
inline

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

Definition at line 121 of file kmheaders.h.

◆ isMessageCut()

bool KMHeaders::isMessageCut ( TQ_UINT32  serNum) const

Returns true if the message with the given serial number has been cut.

Parameters
serNumA message serial number.

Definition at line 3596 of file kmheaders.cpp.

◆ isThreaded()

bool KMHeaders::isThreaded ( ) const
inline

Returns true if the current header list is threaded.

Definition at line 166 of file kmheaders.h.

◆ makeHeaderVisible()

void KMHeaders::makeHeaderVisible ( )
protected

Ensure the current item is visible.

Definition at line 2098 of file kmheaders.cpp.

◆ maybeDeleting

void KMHeaders::maybeDeleting ( )
signal

emitted when we might be about to delete messages

◆ messageListUpdated

void KMHeaders::messageListUpdated ( )
signal

emitted when the list of messages has been completely rebuilt

◆ moveMsgToFolder()

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 1586 of file kmheaders.cpp.

◆ moveSelectedToFolder

void KMHeaders::moveSelectedToFolder ( int  menuId)
protectedvirtualslot

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

Definition at line 1531 of file kmheaders.cpp.

◆ msgAdded

void KMHeaders::msgAdded ( int  id)
slot

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

Definition at line 895 of file kmheaders.cpp.

◆ msgAddedToListView

void KMHeaders::msgAddedToListView ( TQListViewItem *  )
signal

emitted after a new item has been fully built and added to the list view.

We can't use TDEListView::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.

◆ msgChanged

void KMHeaders::msgChanged ( )
slot

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

Definition at line 816 of file kmheaders.cpp.

◆ msgHeaderChanged

void KMHeaders::msgHeaderChanged ( KMFolder folder,
int  msgId 
)
slot

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

Definition at line 1210 of file kmheaders.cpp.

◆ msgRemoved

void KMHeaders::msgRemoved ( int  id,
TQString  msgId 
)
slot

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

Definition at line 1081 of file kmheaders.cpp.

◆ nextMessage

void KMHeaders::nextMessage ( )
slot

Make the next header visible scrolling if necessary.

Definition at line 1804 of file kmheaders.cpp.

◆ nextUnreadMessage

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 2040 of file kmheaders.cpp.

◆ owner()

KMMainWidget* KMHeaders::owner ( void  ) const
inline

Returns pointer to owning main window.

Definition at line 124 of file kmheaders.h.

◆ paintEmptyArea()

void KMHeaders::paintEmptyArea ( TQPainter *  p,
const TQRect &  rect 
)
protectedvirtual

Overridden to support backing pixmap.

Definition at line 403 of file kmheaders.cpp.

◆ paintInfo()

const KPaintInfo* KMHeaders::paintInfo ( void  ) const
inline

PaintInfo pointer.

Definition at line 127 of file kmheaders.h.

◆ prevMessage

void KMHeaders::prevMessage ( )
slot

Make the previous header visible scrolling if necessary.

Definition at line 1841 of file kmheaders.cpp.

◆ prevUnreadMessage

bool KMHeaders::prevUnreadMessage ( )
slot

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

Definition at line 2066 of file kmheaders.cpp.

◆ readColorConfig()

void KMHeaders::readColorConfig ( void  )
virtual

Read color options and set palette.

Definition at line 426 of file kmheaders.cpp.

◆ readConfig()

void KMHeaders::readConfig ( void  )
virtual

Read config options.

Definition at line 468 of file kmheaders.cpp.

◆ readFolderConfig()

void KMHeaders::readFolderConfig ( void  )
protectedvirtual

Read per-folder config options and apply them.

Definition at line 608 of file kmheaders.cpp.

◆ refreshNestedState()

void KMHeaders::refreshNestedState ( void  )

read the config file and update nested state if necessary

Definition at line 589 of file kmheaders.cpp.

◆ reset

void KMHeaders::reset ( )
slot

Refresh the list of message headers shown.

Definition at line 570 of file kmheaders.cpp.

◆ resetCurrentTime

void KMHeaders::resetCurrentTime ( )
slot

timer function to set the current time regularly

Definition at line 2157 of file kmheaders.cpp.

◆ restoreColumnLayout()

void KMHeaders::restoreColumnLayout ( TDEConfig *  config,
const TQString &  group 
)

Same as TDEListView::restoreLayout(), only that this does not restore the sort order.

This is useful since restoreLayout() doesn't restore the sort order correctly, as TDEListView doesn't know about our extended sort order like date of arrival.

Note that if you want to restore the sort order correctly, call readConfig().

Definition at line 559 of file kmheaders.cpp.

◆ rightButtonPressed

void KMHeaders::rightButtonPressed ( TQListViewItem *  lvi,
const TQPoint &  ,
int   
)
protectedslot

show context menu

Definition at line 2263 of file kmheaders.cpp.

◆ selectCurrentMessage

void KMHeaders::selectCurrentMessage ( )
slot

Select the message which currently has focus, if it's not already selected.

Definition at line 1914 of file kmheaders.cpp.

◆ selected

void KMHeaders::selected ( KMMessage )
signal

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

◆ selectedItems()

TQValueList< int > KMHeaders::selectedItems ( )

Returns the index values of currently selected items.

Definition at line 1776 of file kmheaders.cpp.

◆ selectedMsgs()

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 1755 of file kmheaders.cpp.

◆ selectedSernums()

TQValueList< TQ_UINT32 > KMHeaders::selectedSernums ( )

Returns the sernums of all selected items.

Definition at line 3601 of file kmheaders.cpp.

◆ selectedVisibleSernums()

TQValueList< TQ_UINT32 > KMHeaders::selectedVisibleSernums ( )

Returns the sernums of all visible (ie.

items with expanded parent, not hidden by eg. the quick search) selected items.

Definition at line 3616 of file kmheaders.cpp.

◆ selectMessage

void KMHeaders::selectMessage ( TQListViewItem *  lvi)
slot

For when a list view item has been double clicked.

Definition at line 2166 of file kmheaders.cpp.

◆ selectNextMessage

void KMHeaders::selectNextMessage ( )
slot

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

Definition at line 1816 of file kmheaders.cpp.

◆ selectPrevMessage

void KMHeaders::selectPrevMessage ( )
slot

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

Definition at line 1853 of file kmheaders.cpp.

◆ setCopiedMessages()

void KMHeaders::setCopiedMessages ( const TQValueList< TQ_UINT32 > &  msgs,
bool  move 
)

Sets the list of copied/cutted messages.

Parameters
msgsA list of serial numbers.
moveif true, the messages were cutted

Definition at line 3589 of file kmheaders.cpp.

◆ setCurrentItemByIndex()

void KMHeaders::setCurrentItemByIndex ( int  msgIdx)
virtual

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

Definition at line 2543 of file kmheaders.cpp.

◆ setCurrentItemBySerialNum()

void KMHeaders::setCurrentItemBySerialNum ( unsigned long  serialNum)

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

Definition at line 3513 of file kmheaders.cpp.

◆ setCurrentMsg()

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 1692 of file kmheaders.cpp.

◆ setFolder()

void KMHeaders::setFolder ( KMFolder aFolder,
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 678 of file kmheaders.cpp.

◆ setFolderInfoStatus

void KMHeaders::setFolderInfoStatus ( )
slot

Provide information about number of messages in a folder.

Definition at line 1391 of file kmheaders.cpp.

◆ setMsgStatus()

void KMHeaders::setMsgStatus ( KMMsgStatus  status,
bool  toggle = false 
)
virtual

The following methods processes all selected messages.

Definition at line 1222 of file kmheaders.cpp.

◆ setOpen()

void KMHeaders::setOpen ( TQListViewItem *  item,
bool  open 
)
virtual

Double force items to always be open.

Definition at line 2602 of file kmheaders.cpp.

◆ setSelected

void KMHeaders::setSelected ( TQListViewItem *  item,
bool  selected 
)
virtualslot

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

Definition at line 1707 of file kmheaders.cpp.

◆ setSelectedByIndex

void KMHeaders::setSelectedByIndex ( TQValueList< 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 1727 of file kmheaders.cpp.

◆ setSorting()

void KMHeaders::setSorting ( int  column,
bool  ascending = true 
)
protectedvirtual

Called when a header is clicked.

Definition at line 2616 of file kmheaders.cpp.

◆ setStyleDependantFrameWidth()

void KMHeaders::setStyleDependantFrameWidth ( )
protected

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

Definition at line 1369 of file kmheaders.cpp.

◆ setThreadStatus()

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 1256 of file kmheaders.cpp.

◆ setTopItemByIndex()

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 2570 of file kmheaders.cpp.

◆ slotExpandOrCollapseAllThreads

void KMHeaders::slotExpandOrCollapseAllThreads ( bool  expand)
slot

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

Definition at line 1344 of file kmheaders.cpp.

◆ slotExpandOrCollapseThread

void KMHeaders::slotExpandOrCollapseThread ( bool  expand)
slot

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

Definition at line 1327 of file kmheaders.cpp.

◆ slotFilterMsg

int KMHeaders::slotFilterMsg ( KMMessage msg)
protectedvirtualslot

Apply the filter Rules to a single message.

Definition at line 1305 of file kmheaders.cpp.

◆ slotNoDrag

void KMHeaders::slotNoDrag ( )
slot

Don't show a drag cursor.

Definition at line 2086 of file kmheaders.cpp.

◆ slotRMB

void KMHeaders::slotRMB ( )
slot

For when righ mouse button is pressed.

Definition at line 2424 of file kmheaders.cpp.

◆ slotToggleColumn

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 259 of file kmheaders.cpp.

◆ styleChange()

void KMHeaders::styleChange ( TQStyle &  oldStyle)
protected

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

Definition at line 1384 of file kmheaders.cpp.

◆ topItemIndex()

int KMHeaders::topItemIndex ( )
virtual

Return the message id of the top most visible item.

Definition at line 2560 of file kmheaders.cpp.

◆ writeConfig()

void KMHeaders::writeConfig ( void  )
virtual

Write global config options.

Definition at line 659 of file kmheaders.cpp.

◆ writeFolderConfig()

void KMHeaders::writeFolderConfig ( void  )
protectedvirtual

Write per-folder config options.

Definition at line 638 of file kmheaders.cpp.


The documentation for this class was generated from the following files: