messageitem.h

Go to the documentation of this file.

/******************************************************************************
 *
 *  Copyright 2008 Szymon Tomasz Stefanek <pragma@kvirc.net>
 *
 *  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; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  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.
 *
 *******************************************************************************/

#ifndef __MESSAGELIST_CORE_MESSAGEITEM_H__
#define __MESSAGELIST_CORE_MESSAGEITEM_H__

#include <messagelist/core/item.h>
#include <messagelist/core/modelinvariantindex.h>

#include <QPixmap>
#include <QString>
#include <QColor>

#include <messagelist/messagelist_export.h>
#include "theme.h"

namespace Akonadi {
class Item;
}

namespace MessageList
{

namespace Core
{

class MessageItemPrivate;

class MESSAGELIST_EXPORT MessageItem : public Item, public ModelInvariantIndex
{
public:
    class MESSAGELIST_EXPORT Tag
    {
    public:
        explicit Tag( const QPixmap &pix, const QString &tagName, const QString &tagId );
        ~Tag();
        QPixmap pixmap() const;
        QString name() const;
        QString id() const;
        QColor textColor() const;
        QColor backgroundColor() const;
        QFont font() const;
        int priority() const;

        void setTextColor( const QColor &textColor );
        void setBackgroundColor( const QColor &backgroundColor );
        void setFont( const QFont &font );
        void setPriority( int priority );

    private:
        class Private;
        Private * const d;
    };

    enum ThreadingStatus
    {
        PerfectParentFound,     
        ImperfectParentFound,   
        ParentMissing,          
        NonThreadable           
    };

    enum EncryptionState
    {
        NotEncrypted,
        PartiallyEncrypted,
        FullyEncrypted,
        EncryptionStateUnknown
    };

    enum SignatureState
    {
        NotSigned,
        PartiallySigned,
        FullySigned,
        SignatureStateUnknown
    };

    explicit MessageItem();
    virtual ~MessageItem();

public:

    virtual QList< Tag * > tagList() const;

    virtual bool hasAnnotation() const;

    QString annotation() const;

    void editAnnotation();

    const Tag * findTag( const QString &szTagId ) const;

    QString tagListDescription() const;

    void invalidateTagCache();

    void invalidateAnnotationCache();

    QColor textColor() const;

    QColor backgroundColor() const;

    QFont font() const;

    QString fontKey() const;

    SignatureState signatureState() const;

    void setSignatureState( SignatureState state );

    EncryptionState encryptionState() const;

    void setEncryptionState( EncryptionState state );

    QByteArray messageIdMD5() const;

    void setMessageIdMD5( const QByteArray &md5 );

    QByteArray inReplyToIdMD5() const;

    void setInReplyToIdMD5( const QByteArray &md5 );

    QByteArray referencesIdMD5() const;

    void setReferencesIdMD5( const QByteArray &md5 );

    void setSubjectIsPrefixed( bool subjectIsPrefixed );

    bool subjectIsPrefixed() const;

    QByteArray strippedSubjectMD5() const;

    void setStrippedSubjectMD5( const QByteArray &md5 );

    bool aboutToBeRemoved() const;

    void setAboutToBeRemoved( bool aboutToBeRemoved );

    ThreadingStatus threadingStatus() const;

    void setThreadingStatus( ThreadingStatus threadingStatus );

    unsigned long uniqueId() const;

    Akonadi::Item akonadiItem() const;
    void setAkonadiItem( const Akonadi::Item &item );

    MessageItem * topmostMessage();

    QString accessibleText( const MessageList::Core::Theme* theme, int columnIndex );

    void subTreeToList( QList< MessageItem * > &list );

    //
    // Colors and fonts shared by all message items.
    // textColor() and font() will take the message status into account and return
    // one of these.
    // Call these setters only once when reading the colors from the config file.
    //
    static void setUnreadMessageColor( const QColor &color );
    static void setImportantMessageColor( const QColor &color );
    static void setToDoMessageColor( const QColor &color );
    static void setGeneralFont( const QFont &font );
    static void setUnreadMessageFont( const QFont &font );
    static void setImportantMessageFont( const QFont &font );
    static void setToDoMessageFont( const QFont &font );

protected:
    explicit MessageItem( MessageItemPrivate* dd );
private:

    QString accessibleTextForField( Theme::ContentItem::Type field );

    Q_DECLARE_PRIVATE( MessageItem )
};


class FakeItemPrivate;

class MESSAGELIST_EXPORT FakeItem : public MessageItem
{
public:

    explicit FakeItem();
    ~FakeItem();

    virtual QList< Tag * > tagList() const;

    void setFakeTags( const QList< Tag* > &tagList );

    virtual bool hasAnnotation() const;

private:
    Q_DECLARE_PRIVATE( FakeItem )
};

} // namespace Core

} // namespace MessageList

#endif