KviStatusBar.h

Go to the documentation of this file.

#ifndef _KVI_STATUSBAR_H_
#define _KVI_STATUSBAR_H_
//=============================================================================
//
//   File : KviStatusBar.h
//   Creation date : Tue 07 Sep 2004 03:56:46 by Szymon Stefanek
//
//   This file is part of the KVIrc IRC client distribution
//   Copyright (C) 2004-2010 Szymon Stefanek <pragma at kvirc dot 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.
//
//=============================================================================

#include "kvi_settings.h"
#include "KviPointerList.h"
#include "KviHeapObject.h"
#include "KviPointerHashTable.h"
#include "KviTalHBox.h"

#include <QString>
#include <QStatusBar>
#include <QHelpEvent>

class QTimer;
class QLabel;
class KviMainWindow;
class QMenu;
class KviStatusBarApplet;
class KviStatusBarAppletDescriptor;
class KviIrcContext;
class KviDynamicToolTip;

#define VMARGIN 3
//#define HMARGIN 4
//#define SPACING 3
#define RICHTEXTLABELTRICK 2

class KVIRC_API KviStatusBarMessage : public KviHeapObject
{
        friend class KviStatusBar;

protected:
        QString m_szText;
        unsigned int m_uTimeout;
        unsigned int m_uPriority;

public:
        KviStatusBarMessage(const QString & szText, unsigned int uTimeout = 8000, unsigned int uPriority = 0)
            : KviHeapObject(), m_szText(szText), m_uTimeout(uTimeout), m_uPriority(uPriority){};

        ~KviStatusBarMessage(){};

public:
        const QString & text() { return m_szText; };

        unsigned int timeout() { return m_uTimeout; };

        unsigned int priority() { return m_uPriority; };
};

class KVIRC_API KviStatusBar : public QStatusBar
{
        friend class KviStatusBarApplet;
        friend class KviMainWindow;
        Q_OBJECT
public:
        KviStatusBar(KviMainWindow * pFrame);

        ~KviStatusBar();

protected:
        KviTalHBox * m_pBox;
        KviMainWindow * m_pFrame;
        KviPointerList<KviStatusBarMessage> * m_pMessageQueue;
        QTimer * m_pMessageTimer;
        QLabel * m_pMessageLabel;
        KviPointerList<KviStatusBarApplet> * m_pAppletList;
        KviPointerHashTable<QString, KviStatusBarAppletDescriptor> * m_pAppletDescriptors;
        QMenu * m_pContextPopup;
        QMenu * m_pAppletsPopup;
        KviStatusBarApplet * m_pClickedApplet;
        int m_iLastMinimumHeight;
        bool m_bStopLayoutOnAddRemove;
        KviDynamicToolTip * m_pToolTip;

public:
        KviMainWindow * frame() { return m_pFrame; };

        bool appletExists(KviStatusBarApplet * pApplet);

        KviStatusBarApplet * appletAt(const QPoint & pnt, bool bBestMatch = false);

        //QMenu * contextPopup();

        void queueMessage(KviStatusBarMessage * pMsg);

        void registerAppletDescriptor(KviStatusBarAppletDescriptor * d);

        int insertPermanentWidgetAtTheEnd(QWidget * widget, int stretch = 0);

        //void addApplet(KviStatusBarApplet * pApplet);
        //void removeApplet(KviStatusBarApplet * pApplet);
protected:
        void showFirstMessageInQueue();

        void registerApplet(KviStatusBarApplet * pApplet);

        void unregisterApplet(KviStatusBarApplet * pApplet);

        void recalcMinimumHeight();

        void save();

        void load();

        KviStatusBarApplet * createApplet(const QString & szInternalName);

        void showLayoutHelp();

        void tipRequest(QHelpEvent * e);
protected slots:
        void messageTimerFired();

        void contextMenuRequested(const QPoint & pos);

        void contextPopupAboutToShow();

        void appletsPopupAboutToShow();

        void appletsPopupActivated(QAction * pAction);

        void removeClickedApplet();

        void setPermanentMessage();

protected:
        virtual void mousePressEvent(QMouseEvent * e);
        virtual void mouseDoubleClickEvent(QMouseEvent * e);
        virtual bool event(QEvent * e);
        void dropEvent(QDropEvent * de);
        void dragMoveEvent(QDragMoveEvent * de);
        void dragEnterEvent(QDragEnterEvent * event);
};

#endif // _KVI_STATUSBAR_H_