diff options
Diffstat (limited to 'src/gui/util/qsystemtrayicon.cpp')
-rw-r--r-- | src/gui/util/qsystemtrayicon.cpp | 674 |
1 files changed, 0 insertions, 674 deletions
diff --git a/src/gui/util/qsystemtrayicon.cpp b/src/gui/util/qsystemtrayicon.cpp deleted file mode 100644 index 28d493248f..0000000000 --- a/src/gui/util/qsystemtrayicon.cpp +++ /dev/null @@ -1,674 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). -** All rights reserved. -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** This file is part of the QtGui module of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:LGPL$ -** GNU Lesser General Public License Usage -** This file may be used under the terms of the GNU Lesser General Public -** License version 2.1 as published by the Free Software Foundation and -** appearing in the file LICENSE.LGPL included in the packaging of this -** file. Please review the following information to ensure the GNU Lesser -** General Public License version 2.1 requirements will be met: -** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. -** -** In addition, as a special exception, Nokia gives you certain additional -** rights. These rights are described in the Nokia Qt LGPL Exception -** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. -** -** GNU General Public License Usage -** Alternatively, this file may be used under the terms of the GNU General -** Public License version 3.0 as published by the Free Software Foundation -** and appearing in the file LICENSE.GPL included in the packaging of this -** file. Please review the following information to ensure the GNU General -** Public License version 3.0 requirements will be met: -** http://www.gnu.org/copyleft/gpl.html. -** -** Other Usage -** Alternatively, this file may be used in accordance with the terms and -** conditions contained in a signed written agreement between you and Nokia. -** -** -** -** -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -#include "qsystemtrayicon.h" -#include "qsystemtrayicon_p.h" - -#ifndef QT_NO_SYSTEMTRAYICON - -#include "qmenu.h" -#include "qevent.h" -#include "qpoint.h" -#include "qlabel.h" -#include "qpushbutton.h" -#include "qpainterpath.h" -#include "qpainter.h" -#include "qstyle.h" -#include "qgridlayout.h" -#include "qapplication.h" -#include "qdesktopwidget.h" -#include "qbitmap.h" -#include "private/qlabel_p.h" -#include "qapplication.h" - -QT_BEGIN_NAMESPACE - -/*! - \class QSystemTrayIcon - \brief The QSystemTrayIcon class provides an icon for an application in the system tray. - \since 4.2 - \ingroup desktop - - Modern operating systems usually provide a special area on the desktop, - called the \e{system tray} or \e{notification area}, where long-running - applications can display icons and short messages. - - \image system-tray.png The system tray on Windows XP. - - The QSystemTrayIcon class can be used on the following platforms: - - \list - \o All supported versions of Windows. - \o All window managers for X11 that implement the \l{freedesktop.org} system - tray specification, including recent versions of KDE and GNOME. - \o All supported versions of Mac OS X. Note that the Growl - notification system must be installed for - QSystemTrayIcon::showMessage() to display messages. - \endlist - - To check whether a system tray is present on the user's desktop, - call the QSystemTrayIcon::isSystemTrayAvailable() static function. - - To add a system tray entry, create a QSystemTrayIcon object, call setContextMenu() - to provide a context menu for the icon, and call show() to make it visible in the - system tray. Status notification messages ("balloon messages") can be displayed at - any time using showMessage(). - - If the system tray is unavailable when a system tray icon is constructed, but - becomes available later, QSystemTrayIcon will automatically add an entry for the - application in the system tray if the icon is \l visible. - - The activated() signal is emitted when the user activates the icon. - - Only on X11, when a tooltip is requested, the QSystemTrayIcon receives a QHelpEvent - of type QEvent::ToolTip. Additionally, the QSystemTrayIcon receives wheel events of - type QEvent::Wheel. These are not supported on any other platform. - - \sa QDesktopServices, QDesktopWidget, {Desktop Integration}, {System Tray Icon Example} -*/ - -/*! - \enum QSystemTrayIcon::MessageIcon - - This enum describes the icon that is shown when a balloon message is displayed. - - \value NoIcon No icon is shown. - \value Information An information icon is shown. - \value Warning A standard warning icon is shown. - \value Critical A critical warning icon is shown. - - \sa QMessageBox -*/ - -/*! - Constructs a QSystemTrayIcon object with the given \a parent. - - The icon is initially invisible. - - \sa visible -*/ -QSystemTrayIcon::QSystemTrayIcon(QObject *parent) -: QObject(*new QSystemTrayIconPrivate(), parent) -{ -} - -/*! - Constructs a QSystemTrayIcon object with the given \a icon and \a parent. - - The icon is initially invisible. - - \sa visible -*/ -QSystemTrayIcon::QSystemTrayIcon(const QIcon &icon, QObject *parent) -: QObject(*new QSystemTrayIconPrivate(), parent) -{ - setIcon(icon); -} - -/*! - Removes the icon from the system tray and frees all allocated resources. -*/ -QSystemTrayIcon::~QSystemTrayIcon() -{ - Q_D(QSystemTrayIcon); - d->remove_sys(); -} - -#ifndef QT_NO_MENU - -/*! - Sets the specified \a menu to be the context menu for the system tray icon. - - The menu will pop up when the user requests the context menu for the system - tray icon by clicking the mouse button. - - On Mac OS X, this is currenly converted to a NSMenu, so the - aboutToHide() signal is not emitted. - - \note The system tray icon does not take ownership of the menu. You must - ensure that it is deleted at the appropriate time by, for example, creating - the menu with a suitable parent object. -*/ -void QSystemTrayIcon::setContextMenu(QMenu *menu) -{ - Q_D(QSystemTrayIcon); - d->menu = menu; - d->updateMenu_sys(); -} - -/*! - Returns the current context menu for the system tray entry. -*/ -QMenu* QSystemTrayIcon::contextMenu() const -{ - Q_D(const QSystemTrayIcon); - return d->menu; -} - -#endif // QT_NO_MENU - -/*! - \property QSystemTrayIcon::icon - \brief the system tray icon - - On Windows, the system tray icon size is 16x16; on X11, the preferred size is - 22x22. The icon will be scaled to the appropriate size as necessary. -*/ -void QSystemTrayIcon::setIcon(const QIcon &icon) -{ - Q_D(QSystemTrayIcon); - d->icon = icon; - d->updateIcon_sys(); -} - -QIcon QSystemTrayIcon::icon() const -{ - Q_D(const QSystemTrayIcon); - return d->icon; -} - -/*! - \property QSystemTrayIcon::toolTip - \brief the tooltip for the system tray entry - - On some systems, the tooltip's length is limited. The tooltip will be truncated - if necessary. -*/ -void QSystemTrayIcon::setToolTip(const QString &tooltip) -{ - Q_D(QSystemTrayIcon); - d->toolTip = tooltip; - d->updateToolTip_sys(); -} - -QString QSystemTrayIcon::toolTip() const -{ - Q_D(const QSystemTrayIcon); - return d->toolTip; -} - -/*! - \fn void QSystemTrayIcon::show() - - Shows the icon in the system tray. - - \sa hide(), visible -*/ - -/*! - \fn void QSystemTrayIcon::hide() - - Hides the system tray entry. - - \sa show(), visible -*/ - -/*! - \since 4.3 - Returns the geometry of the system tray icon in screen coordinates. - - \sa visible -*/ -QRect QSystemTrayIcon::geometry() const -{ - Q_D(const QSystemTrayIcon); - if (!d->visible) - return QRect(); - return d->geometry_sys(); -} - -/*! - \property QSystemTrayIcon::visible - \brief whether the system tray entry is visible - - Setting this property to true or calling show() makes the system tray icon - visible; setting this property to false or calling hide() hides it. -*/ -void QSystemTrayIcon::setVisible(bool visible) -{ - Q_D(QSystemTrayIcon); - if (visible == d->visible) - return; - if (d->icon.isNull() && visible) - qWarning("QSystemTrayIcon::setVisible: No Icon set"); - d->visible = visible; - if (d->visible) - d->install_sys(); - else - d->remove_sys(); -} - -bool QSystemTrayIcon::isVisible() const -{ - Q_D(const QSystemTrayIcon); - return d->visible; -} - -/*! - \reimp -*/ -bool QSystemTrayIcon::event(QEvent *e) -{ -#if defined(Q_WS_X11) - if (e->type() == QEvent::ToolTip) { - Q_D(QSystemTrayIcon); - return d->sys->deliverToolTipEvent(e); - } -#endif - return QObject::event(e); -} - -/*! - \enum QSystemTrayIcon::ActivationReason - - This enum describes the reason the system tray was activated. - - \value Unknown Unknown reason - \value Context The context menu for the system tray entry was requested - \value DoubleClick The system tray entry was double clicked - \value Trigger The system tray entry was clicked - \value MiddleClick The system tray entry was clicked with the middle mouse button - - \sa activated() -*/ - -/*! - \fn void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason) - - This signal is emitted when the user activates the system tray icon. \a reason - specifies the reason for activation. QSystemTrayIcon::ActivationReason enumerates - the various reasons. - - \sa QSystemTrayIcon::ActivationReason -*/ - -/*! - \fn void QSystemTrayIcon::messageClicked() - - This signal is emitted when the message displayed using showMessage() - was clicked by the user. - - Currently this signal is not sent on Mac OS X. - - \note We follow Microsoft Windows XP/Vista behavior, so the - signal is also emitted when the user clicks on a tray icon with - a balloon message displayed. - - \sa activated() -*/ - - -/*! - Returns true if the system tray is available; otherwise returns false. - - If the system tray is currently unavailable but becomes available later, - QSystemTrayIcon will automatically add an entry in the system tray if it - is \l visible. -*/ - -bool QSystemTrayIcon::isSystemTrayAvailable() -{ - return QSystemTrayIconPrivate::isSystemTrayAvailable_sys(); -} - -/*! - Returns true if the system tray supports balloon messages; otherwise returns false. - - \sa showMessage() -*/ -bool QSystemTrayIcon::supportsMessages() -{ - return QSystemTrayIconPrivate::supportsMessages_sys(); -} - -/*! - \fn void QSystemTrayIcon::showMessage(const QString &title, const QString &message, MessageIcon icon, int millisecondsTimeoutHint) - \since 4.3 - - Shows a balloon message for the entry with the given \a title, \a message and - \a icon for the time specified in \a millisecondsTimeoutHint. \a title and \a message - must be plain text strings. - - Message can be clicked by the user; the messageClicked() signal will emitted when - this occurs. - - Note that display of messages are dependent on the system configuration and user - preferences, and that messages may not appear at all. Hence, it should not be - relied upon as the sole means for providing critical information. - - On Windows, the \a millisecondsTimeoutHint is usually ignored by the system - when the application has focus. - - On Mac OS X, the Growl notification system must be installed for this function to - display messages. - - \sa show() supportsMessages() - */ -void QSystemTrayIcon::showMessage(const QString& title, const QString& msg, - QSystemTrayIcon::MessageIcon icon, int msecs) -{ - Q_D(QSystemTrayIcon); - if (d->visible) - d->showMessage_sys(title, msg, icon, msecs); -} - -////////////////////////////////////////////////////////////////////// -static QBalloonTip *theSolitaryBalloonTip = 0; - -void QBalloonTip::showBalloon(QSystemTrayIcon::MessageIcon icon, const QString& title, - const QString& message, QSystemTrayIcon *trayIcon, - const QPoint& pos, int timeout, bool showArrow) -{ - hideBalloon(); - if (message.isEmpty() && title.isEmpty()) - return; - - theSolitaryBalloonTip = new QBalloonTip(icon, title, message, trayIcon); - if (timeout < 0) - timeout = 10000; //10 s default - theSolitaryBalloonTip->balloon(pos, timeout, showArrow); -} - -void QBalloonTip::hideBalloon() -{ - if (!theSolitaryBalloonTip) - return; - theSolitaryBalloonTip->hide(); - delete theSolitaryBalloonTip; - theSolitaryBalloonTip = 0; -} - -bool QBalloonTip::isBalloonVisible() -{ - return theSolitaryBalloonTip; -} - -QBalloonTip::QBalloonTip(QSystemTrayIcon::MessageIcon icon, const QString& title, - const QString& message, QSystemTrayIcon *ti) - : QWidget(0, Qt::ToolTip), trayIcon(ti), timerId(-1) -{ - setAttribute(Qt::WA_DeleteOnClose); - QObject::connect(ti, SIGNAL(destroyed()), this, SLOT(close())); - - QLabel *titleLabel = new QLabel; - titleLabel->installEventFilter(this); - titleLabel->setText(title); - QFont f = titleLabel->font(); - f.setBold(true); -#ifdef Q_WS_WINCE - f.setPointSize(f.pointSize() - 2); -#endif - titleLabel->setFont(f); - titleLabel->setTextFormat(Qt::PlainText); // to maintain compat with windows - -#ifdef Q_WS_WINCE - const int iconSize = style()->pixelMetric(QStyle::PM_SmallIconSize); - const int closeButtonSize = style()->pixelMetric(QStyle::PM_SmallIconSize) - 2; -#else - const int iconSize = 18; - const int closeButtonSize = 15; -#endif - - QPushButton *closeButton = new QPushButton; - closeButton->setIcon(style()->standardIcon(QStyle::SP_TitleBarCloseButton)); - closeButton->setIconSize(QSize(closeButtonSize, closeButtonSize)); - closeButton->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed); - closeButton->setFixedSize(closeButtonSize, closeButtonSize); - QObject::connect(closeButton, SIGNAL(clicked()), this, SLOT(close())); - - QLabel *msgLabel = new QLabel; -#ifdef Q_WS_WINCE - f.setBold(false); - msgLabel->setFont(f); -#endif - msgLabel->installEventFilter(this); - msgLabel->setText(message); - msgLabel->setTextFormat(Qt::PlainText); - msgLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft); - - // smart size for the message label -#ifdef Q_WS_WINCE - int limit = QApplication::desktop()->availableGeometry(msgLabel).size().width() / 2; -#else - int limit = QApplication::desktop()->availableGeometry(msgLabel).size().width() / 3; -#endif - if (msgLabel->sizeHint().width() > limit) { - msgLabel->setWordWrap(true); - if (msgLabel->sizeHint().width() > limit) { - msgLabel->d_func()->ensureTextControl(); - if (QTextControl *control = msgLabel->d_func()->control) { - QTextOption opt = control->document()->defaultTextOption(); - opt.setWrapMode(QTextOption::WrapAnywhere); - control->document()->setDefaultTextOption(opt); - } - } -#ifdef Q_WS_WINCE - // Make sure that the text isn't wrapped "somewhere" in the balloon widget - // in the case that we have a long title label. - setMaximumWidth(limit); -#else - // Here we allow the text being much smaller than the balloon widget - // to emulate the weird standard windows behavior. - msgLabel->setFixedSize(limit, msgLabel->heightForWidth(limit)); -#endif - } - - QIcon si; - switch (icon) { - case QSystemTrayIcon::Warning: - si = style()->standardIcon(QStyle::SP_MessageBoxWarning); - break; - case QSystemTrayIcon::Critical: - si = style()->standardIcon(QStyle::SP_MessageBoxCritical); - break; - case QSystemTrayIcon::Information: - si = style()->standardIcon(QStyle::SP_MessageBoxInformation); - break; - case QSystemTrayIcon::NoIcon: - default: - break; - } - - QGridLayout *layout = new QGridLayout; - if (!si.isNull()) { - QLabel *iconLabel = new QLabel; - iconLabel->setPixmap(si.pixmap(iconSize, iconSize)); - iconLabel->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed); - iconLabel->setMargin(2); - layout->addWidget(iconLabel, 0, 0); - layout->addWidget(titleLabel, 0, 1); - } else { - layout->addWidget(titleLabel, 0, 0, 1, 2); - } - - layout->addWidget(closeButton, 0, 2); - layout->addWidget(msgLabel, 1, 0, 1, 3); - layout->setSizeConstraint(QLayout::SetFixedSize); - layout->setMargin(3); - setLayout(layout); - - QPalette pal = palette(); - pal.setColor(QPalette::Window, QColor(0xff, 0xff, 0xe1)); - pal.setColor(QPalette::WindowText, Qt::black); - setPalette(pal); -} - -QBalloonTip::~QBalloonTip() -{ - theSolitaryBalloonTip = 0; -} - -void QBalloonTip::paintEvent(QPaintEvent *) -{ - QPainter painter(this); - painter.drawPixmap(rect(), pixmap); -} - -void QBalloonTip::resizeEvent(QResizeEvent *ev) -{ - QWidget::resizeEvent(ev); -} - -void QBalloonTip::balloon(const QPoint& pos, int msecs, bool showArrow) -{ - QRect scr = QApplication::desktop()->screenGeometry(pos); - QSize sh = sizeHint(); - const int border = 1; - const int ah = 18, ao = 18, aw = 18, rc = 7; - bool arrowAtTop = (pos.y() + sh.height() + ah < scr.height()); - bool arrowAtLeft = (pos.x() + sh.width() - ao < scr.width()); - setContentsMargins(border + 3, border + (arrowAtTop ? ah : 0) + 2, border + 3, border + (arrowAtTop ? 0 : ah) + 2); - updateGeometry(); - sh = sizeHint(); - - int ml, mr, mt, mb; - QSize sz = sizeHint(); - if (!arrowAtTop) { - ml = mt = 0; - mr = sz.width() - 1; - mb = sz.height() - ah - 1; - } else { - ml = 0; - mt = ah; - mr = sz.width() - 1; - mb = sz.height() - 1; - } - - QPainterPath path; -#if defined(QT_NO_XSHAPE) && defined(Q_WS_X11) - // XShape is required for setting the mask, so we just - // draw an ugly square when its not available - path.moveTo(0, 0); - path.lineTo(sz.width() - 1, 0); - path.lineTo(sz.width() - 1, sz.height() - 1); - path.lineTo(0, sz.height() - 1); - path.lineTo(0, 0); - move(qMax(pos.x() - sz.width(), scr.left()), pos.y()); -#else - path.moveTo(ml + rc, mt); - if (arrowAtTop && arrowAtLeft) { - if (showArrow) { - path.lineTo(ml + ao, mt); - path.lineTo(ml + ao, mt - ah); - path.lineTo(ml + ao + aw, mt); - } - move(qMax(pos.x() - ao, scr.left() + 2), pos.y()); - } else if (arrowAtTop && !arrowAtLeft) { - if (showArrow) { - path.lineTo(mr - ao - aw, mt); - path.lineTo(mr - ao, mt - ah); - path.lineTo(mr - ao, mt); - } - move(qMin(pos.x() - sh.width() + ao, scr.right() - sh.width() - 2), pos.y()); - } - path.lineTo(mr - rc, mt); - path.arcTo(QRect(mr - rc*2, mt, rc*2, rc*2), 90, -90); - path.lineTo(mr, mb - rc); - path.arcTo(QRect(mr - rc*2, mb - rc*2, rc*2, rc*2), 0, -90); - if (!arrowAtTop && !arrowAtLeft) { - if (showArrow) { - path.lineTo(mr - ao, mb); - path.lineTo(mr - ao, mb + ah); - path.lineTo(mr - ao - aw, mb); - } - move(qMin(pos.x() - sh.width() + ao, scr.right() - sh.width() - 2), - pos.y() - sh.height()); - } else if (!arrowAtTop && arrowAtLeft) { - if (showArrow) { - path.lineTo(ao + aw, mb); - path.lineTo(ao, mb + ah); - path.lineTo(ao, mb); - } - move(qMax(pos.x() - ao, scr.x() + 2), pos.y() - sh.height()); - } - path.lineTo(ml + rc, mb); - path.arcTo(QRect(ml, mb - rc*2, rc*2, rc*2), -90, -90); - path.lineTo(ml, mt + rc); - path.arcTo(QRect(ml, mt, rc*2, rc*2), 180, -90); - - // Set the mask - QBitmap bitmap = QBitmap(sizeHint()); - bitmap.fill(Qt::color0); - QPainter painter1(&bitmap); - painter1.setPen(QPen(Qt::color1, border)); - painter1.setBrush(QBrush(Qt::color1)); - painter1.drawPath(path); - setMask(bitmap); -#endif - - // Draw the border - pixmap = QPixmap(sz); - QPainter painter2(&pixmap); - painter2.setPen(QPen(palette().color(QPalette::Window).darker(160), border)); - painter2.setBrush(palette().color(QPalette::Window)); - painter2.drawPath(path); - - if (msecs > 0) - timerId = startTimer(msecs); - show(); -} - -void QBalloonTip::mousePressEvent(QMouseEvent *e) -{ - close(); - if(e->button() == Qt::LeftButton) - emit trayIcon->messageClicked(); -} - -void QBalloonTip::timerEvent(QTimerEvent *e) -{ - if (e->timerId() == timerId) { - killTimer(timerId); - if (!underMouse()) - close(); - return; - } - QWidget::timerEvent(e); -} - -void qtsystray_sendActivated(QSystemTrayIcon *i, int r) -{ - emit i->activated((QSystemTrayIcon::ActivationReason)r); -} - -QT_END_NAMESPACE - -#endif // QT_NO_SYSTEMTRAYICON |