move statusbar code into the directory "statusbar"

svn path=/trunk/KDE/kdebase/apps/; revision=1005704

1 files changed, 168 insertions, 0 deletions

diff --git a/src/statusbar/statusbarmessagelabel.h b/src/statusbar/statusbarmessagelabel.h
new file mode 100644
index 000000000..a5c72b403
--- /dev/null
+++ b/src/statusbar/statusbarmessagelabel.h
@@ -0,0 +1,168 @@
+/***************************************************************************
+ *   Copyright (C) 2006 by Peter Penz                                      *
+ *   [email protected]                                                     *
+ *                                                                         *
+ *   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 STATUSBARMESSAGELABEL_H
+#define STATUSBARMESSAGELABEL_H
+
+#include <statusbar/dolphinstatusbar.h>
+
+#include <QtCore/QList>
+#include <QtGui/QPixmap>
+
+#include <QtGui/QWidget>
+
+class QPaintEvent;
+class QResizeEvent;
+class QPushButton;
+class QTimer;
+
+/**
+ * @brief Represents a message text label as part of the status bar.
+ *
+ * Dependent from the given type automatically a corresponding icon
+ * is shown in front of the text. For message texts having the type
+ * DolphinStatusBar::Error a dynamic color blending is done to get the
+ * attention from the user.
+ */
+class StatusBarMessageLabel : public QWidget
+{
+    Q_OBJECT
+
+public:
+    explicit StatusBarMessageLabel(QWidget* parent);
+    virtual ~StatusBarMessageLabel();
+
+    void setMessage(const QString& text, DolphinStatusBar::Type type);
+
+    DolphinStatusBar::Type type() const;
+
+    const QString& text() const;
+
+    void setDefaultText(const QString& text);
+    const QString& defaultText() const;
+
+    // TODO: maybe a better approach is possible with the size hint
+    void setMinimumTextHeight(int min);
+    int minimumTextHeight() const;
+
+    /**
+     * Returns the gap of the width of the current set text to the
+     * width of the message label. A gap <= 0 means that the text
+     * fits into the available width.
+     */
+    int widthGap() const;
+
+protected:
+    /** @see QWidget::paintEvent() */
+    virtual void paintEvent(QPaintEvent* event);
+
+    /** @see QWidget::resizeEvent() */
+    virtual void resizeEvent(QResizeEvent* event);
+
+private slots:
+    void timerDone();
+
+    /**
+     * Increases the height of the message label so that
+     * the given text fits into given area.
+     */
+    void assureVisibleText();
+
+    /**
+     * Returns the available width in pixels for the text.
+     */
+    int availableTextWidth() const;
+
+    /**
+     * Moves the close button to the upper right corner
+     * of the message label.
+     */
+    void updateCloseButtonPosition();
+
+    /**
+     * Closes the currently shown error message and replaces it
+     * by the next pending message.
+     */
+    void closeErrorMessage();
+
+private:
+    /**
+     * Shows the next pending error message. If no pending message
+     * was in the queue, false is returned.
+     */
+    bool showPendingMessage();
+
+    /**
+     * Resets the message label properties. This is useful when the
+     * result of invoking StatusBarMessageLabel::setMessage() should
+     * not rely on previous states.
+     */
+    void reset();
+
+private:
+    enum State
+    {
+        Default,
+        Illuminate,
+        Illuminated,
+        Desaturate
+    };
+
+    enum { GeometryTimeout = 100 };
+    enum { BorderGap = 2 };
+
+    DolphinStatusBar::Type m_type;
+    State m_state;
+    int m_illumination;
+    int m_minTextHeight;
+    QTimer* m_timer;
+    QString m_text;
+    QString m_defaultText;
+    QList<QString> m_pendingMessages;
+    QPixmap m_pixmap;
+    QPushButton* m_closeButton;
+};
+
+inline DolphinStatusBar::Type StatusBarMessageLabel::type() const
+{
+    return m_type;
+}
+
+inline const QString& StatusBarMessageLabel::text() const
+{
+    return m_text;
+}
+
+inline void StatusBarMessageLabel::setDefaultText(const QString& text)
+{
+    m_defaultText = text;
+}
+
+inline const QString& StatusBarMessageLabel::defaultText() const
+{
+    return m_defaultText;
+}
+
+inline int StatusBarMessageLabel::minimumTextHeight() const
+{
+    return m_minTextHeight;
+}
+
+#endif