src/statusbarmessagelabel.cpp

   1 /***************************************************************************
   2  *   Copyright (C) 2006 by Peter Penz                                      *
   3  *   peter.penz@gmx.at                                                     *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA          *
  19  ***************************************************************************/
  20
  21 #include "statusbarmessagelabel.h"
  22
  23 #include <kglobalsettings.h>
  24 #include <kgraphicsutils.h>
  25 #include <kiconloader.h>
  26 #include <kicon.h>
  27 #include <klocale.h>
  28
  29 #include <QtGui/QFontMetrics>
  30 #include <QtGui/QPainter>
  31 #include <QtGui/QKeyEvent>
  32 #include <QtGui/QPushButton>
  33 #include <QtGui/QPixmap>
  34 #include <QtCore/QTimer>
  35
  36 StatusBarMessageLabel::StatusBarMessageLabel(QWidget* parent) :
  37     QWidget(parent),
  38     m_type(DolphinStatusBar::Default),
  39     m_state(Default),
  40     m_illumination(0),
  41     m_minTextHeight(-1),
  42     m_timer(0),
  43     m_closeButton(0)
  44 {
  45     setMinimumHeight(K3Icon::SizeSmall);
  46
  47     m_timer = new QTimer(this);
  48     connect(m_timer, SIGNAL(timeout()),
  49             this, SLOT(timerDone()));
  50
  51     m_closeButton = new QPushButton(i18n("Close"), this);
  52     m_closeButton->hide();
  53     connect(m_closeButton, SIGNAL(clicked()),
  54             this, SLOT(closeErrorMessage()));
  55 }
  56
  57 StatusBarMessageLabel::~StatusBarMessageLabel()
  58 {}
  59
  60 void StatusBarMessageLabel::setMessage(const QString& text,
  61                                        DolphinStatusBar::Type type)
  62 {
  63     if ((text == m_text) && (type == m_type)) {
  64         return;
  65     }
  66
  67     if (m_type == DolphinStatusBar::Error) {
  68         if (type == DolphinStatusBar::Error) {
  69             m_pendingMessages.insert(0, m_text);
  70         } else if ((m_state != Default) || !m_pendingMessages.isEmpty()) {
  71             // a non-error message should not be shown, as there
  72             // are other pending error messages in the queue
  73             return;
  74         }
  75     }
  76
  77     m_text = text;
  78     m_type = type;
  79
  80     m_timer->stop();
  81     m_illumination = 0;
  82     m_state = Default;
  83
  84     const char* iconName = 0;
  85     QPixmap pixmap;
  86     switch (type) {
  87     case DolphinStatusBar::OperationCompleted:
  88         iconName = "ok";
  89         m_closeButton->hide();
  90         break;
  91
  92     case DolphinStatusBar::Information:
  93         iconName = "dialog-information";
  94         m_closeButton->hide();
  95         break;
  96
  97     case DolphinStatusBar::Error:
  98         iconName = "dialog-error";
  99         m_timer->start(100);
 100         m_state = Illuminate;
 101
 102         updateCloseButtonPosition();
 103         m_closeButton->show();
 104         break;
 105
 106     case DolphinStatusBar::Default:
 107     default:
 108         m_closeButton->hide();
 109         break;
 110     }
 111
 112     m_pixmap = (iconName == 0) ? QPixmap() : SmallIcon(iconName);
 113     QTimer::singleShot(GeometryTimeout, this, SLOT(assureVisibleText()));
 114     update();
 115 }
 116
 117 void StatusBarMessageLabel::setMinimumTextHeight(int min)
 118 {
 119     if (min != m_minTextHeight) {
 120         m_minTextHeight = min;
 121         setMinimumHeight(min);
 122         m_closeButton->setFixedHeight(min - borderGap() * 2);
 123     }
 124 }
 125
 126 int StatusBarMessageLabel::widthGap() const
 127 {
 128     QFontMetrics fontMetrics(font());
 129     const int defaultGap = 10;
 130     return fontMetrics.width(m_text) - availableTextWidth() + defaultGap;
 131 }
 132
 133 void StatusBarMessageLabel::paintEvent(QPaintEvent* /* event */)
 134 {
 135     QPainter painter(this);
 136
 137     // draw background
 138     QColor backgroundColor(palette().brush(QPalette::Background).color());
 139     QColor foregroundColor(KGlobalSettings::textColor());
 140     if (m_illumination > 0) {
 141         QColor mixColor(255, 255, 128);
 142         mixColor.setAlpha(m_illumination);
 143         backgroundColor = KGraphicsUtils::blendColor(backgroundColor, mixColor);
 144
 145         mixColor.setRgb(0, 0, 0, m_illumination);
 146         foregroundColor = KGraphicsUtils::blendColor(foregroundColor, mixColor);
 147     }
 148     painter.setBrush(backgroundColor);
 149     painter.setPen(backgroundColor);
 150     painter.drawRect(QRect(0, 0, width(), height()));
 151
 152     // draw pixmap
 153     int x = borderGap();
 154     int y = (m_minTextHeight - m_pixmap.height()) / 2;
 155
 156     if (!m_pixmap.isNull()) {
 157         painter.drawPixmap(x, y, m_pixmap);
 158         x += m_pixmap.width() + borderGap();
 159     }
 160
 161     // draw text
 162     painter.setPen(foregroundColor);
 163     int flags = Qt::AlignVCenter;
 164     if (height() > m_minTextHeight) {
 165         flags = flags | Qt::TextWordWrap;
 166     }
 167     painter.drawText(QRect(x, 0, availableTextWidth(), height()), flags, m_text);
 168     painter.end();
 169 }
 170
 171 void StatusBarMessageLabel::resizeEvent(QResizeEvent* event)
 172 {
 173     QWidget::resizeEvent(event);
 174     updateCloseButtonPosition();
 175     QTimer::singleShot(GeometryTimeout, this, SLOT(assureVisibleText()));
 176 }
 177
 178 void StatusBarMessageLabel::timerDone()
 179 {
 180     switch (m_state) {
 181     case Illuminate: {
 182         // increase the illumination
 183         if (m_illumination < 255) {
 184             m_illumination += 32;
 185             if (m_illumination > 255) {
 186                 m_illumination = 255;
 187             }
 188             update();
 189         } else {
 190             m_state = Illuminated;
 191             m_timer->start(5000);
 192         }
 193         break;
 194     }
 195
 196     case Illuminated: {
 197         // start desaturation
 198         m_state = Desaturate;
 199         m_timer->start(100);
 200         break;
 201     }
 202
 203     case Desaturate: {
 204         // desaturate
 205         if (m_illumination > 0) {
 206             m_illumination -= 5;
 207             update();
 208         } else {
 209             m_state = Default;
 210             m_timer->stop();
 211         }
 212         break;
 213     }
 214
 215     default:
 216         break;
 217     }
 218 }
 219
 220 void StatusBarMessageLabel::assureVisibleText()
 221 {
 222     if (m_text.isEmpty()) {
 223         return;
 224     }
 225
 226     // calculate the required height of the widget thats
 227     // needed for having a fully visible text
 228     QFontMetrics fontMetrics(font());
 229     const QRect bounds(fontMetrics.boundingRect(0, 0, availableTextWidth(), height(),
 230                        Qt::AlignVCenter | Qt::TextWordWrap,
 231                        m_text));
 232     int requiredHeight = bounds.height();
 233     if (requiredHeight < m_minTextHeight) {
 234         requiredHeight = m_minTextHeight;
 235     }
 236
 237     // Increase/decrease the current height of the widget to the
 238     // required height. The increasing/decreasing is done in several
 239     // steps to have an animation if the height is modified
 240     // (see StatusBarMessageLabel::resizeEvent())
 241     const int gap = m_minTextHeight / 2;
 242     int minHeight = minimumHeight();
 243     if (minHeight < requiredHeight) {
 244         minHeight += gap;
 245         if (minHeight > requiredHeight) {
 246             minHeight = requiredHeight;
 247         }
 248         setMinimumHeight(minHeight);
 249         updateGeometry();
 250     } else if (minHeight > requiredHeight) {
 251         minHeight -= gap;
 252         if (minHeight < requiredHeight) {
 253             minHeight = requiredHeight;
 254         }
 255         setMinimumHeight(minHeight);
 256         updateGeometry();
 257     }
 258
 259     updateCloseButtonPosition();
 260 }
 261
 262 int StatusBarMessageLabel::availableTextWidth() const
 263 {
 264     const int buttonWidth = (m_type == DolphinStatusBar::Error) ?
 265                             m_closeButton->width() + borderGap() : 0;
 266     return width() - m_pixmap.width() - (borderGap() * 4) - buttonWidth;
 267 }
 268
 269 void StatusBarMessageLabel::updateCloseButtonPosition()
 270 {
 271     const int x = width() - m_closeButton->width() - borderGap();
 272     const int y = height() - m_closeButton->height() - borderGap();
 273     m_closeButton->move(x, y);
 274 }
 275
 276 void StatusBarMessageLabel::closeErrorMessage()
 277 {
 278     if (!showPendingMessage()) {
 279         reset();
 280         setMessage(m_defaultText, DolphinStatusBar::Default);
 281     }
 282 }
 283
 284 bool StatusBarMessageLabel::showPendingMessage()
 285 {
 286     if (!m_pendingMessages.isEmpty()) {
 287         reset();
 288         setMessage(m_pendingMessages.takeFirst(), DolphinStatusBar::Error);
 289         return true;
 290     }
 291     return false;
 292 }
 293
 294 void StatusBarMessageLabel::reset()
 295 {
 296     m_text.clear();
 297     m_type = DolphinStatusBar::Default;
 298 }
 299
 300 #include "statusbarmessagelabel.moc"