QBalloonTip Class Reference

#include <qsystemtrayicon_p.h>

Inheritance diagram for QBalloonTip:

[legend]Collaboration diagram for QBalloonTip:

[legend]List of all members.

---

Detailed Description

Definition at line 75 of file qsystemtrayicon_p.h.

Static Public Member Functions
static void	showBalloon (QSystemTrayIcon::MessageIcon icon, const QString &title, const QString &msg, QSystemTrayIcon *trayIcon, const QPoint &pos, int timeout, bool showArrow=true)
static void	hideBalloon ()
Protected Member Functions
void	paintEvent (QPaintEvent *)
void	resizeEvent (QResizeEvent *)
void	mousePressEvent (QMouseEvent *e)
void	timerEvent (QTimerEvent *e)
Private Member Functions
	QBalloonTip (QSystemTrayIcon::MessageIcon icon, const QString &title, const QString &msg, QSystemTrayIcon *trayIcon)
	~QBalloonTip ()
void	balloon (const QPoint &, int, bool)
Private Attributes
QSystemTrayIcon *	trayIcon
QPixmap	pixmap
int	timerId

---

Constructor & Destructor Documentation

QBalloonTip::QBalloonTip	(	QSystemTrayIcon::MessageIcon	icon,
		const QString &	title,
		const QString &	msg,
		QSystemTrayIcon *	trayIcon
	)			[private]

Definition at line 384 of file qsystemtrayicon.cpp.

References QLayout::addWidget(), Qt::AlignLeft, Qt::AlignTop, QWidget::close(), QObject::connect(), QSystemTrayIcon::Critical, QObject::destroyed(), QSizePolicy::Fixed, QWidget::font(), QSystemTrayIcon::Information, QObject::installEventFilter(), QIcon::isNull(), QWidget::layout(), message, QSystemTrayIcon::NoIcon, QWidget::palette(), QIcon::pixmap(), Qt::PlainText, QLabel::setAlignment(), QWidget::setAttribute(), QFont::setBold(), QPalette::setColor(), QWidget::setFixedSize(), QLayout::SetFixedSize, QWidget::setFont(), QAbstractButton::setIcon(), QAbstractButton::setIconSize(), QWidget::setLayout(), QLayout::setMargin(), QWidget::setPalette(), QLayout::setSizeConstraint(), QWidget::setSizePolicy(), QLayout::setSpacing(), QLabel::setText(), QLabel::setTextFormat(), SIGNAL, SLOT, QStyle::SP_DockWidgetCloseButton, QStyle::SP_MessageBoxCritical, QStyle::SP_MessageBoxInformation, QStyle::SP_MessageBoxWarning, QStyle::standardIcon(), QWidget::style(), Qt::WA_DeleteOnClose, QSystemTrayIcon::Warning, and QPalette::Window.

Referenced by showBalloon().

    : 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);
    titleLabel->setFont(f);
    titleLabel->setTextFormat(Qt::PlainText); // to maintain compat with windows

    QPushButton *closeButton = new QPushButton;
    closeButton->setIcon(style()->standardIcon(QStyle::SP_DockWidgetCloseButton));
    closeButton->setIconSize(QSize(18, 18));
    closeButton->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
    closeButton->setFixedSize(18, 18);
    QObject::connect(closeButton, SIGNAL(clicked()), this, SLOT(close()));

    QLabel *msgLabel = new QLabel;
    msgLabel->installEventFilter(this);
    msgLabel->setText(message);
    msgLabel->setTextFormat(Qt::PlainText);
    msgLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft);

    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(15, 15));
        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);
    layout->setSpacing(1);
    setLayout(layout);

    QPalette pal = palette();
    pal.setColor(QPalette::Window, QColor(0xff, 0xff, 0xe1));
    setPalette(pal);
}

Here is the call graph for this function:

QBalloonTip::~QBalloonTip

(

)

[private]

Definition at line 452 of file qsystemtrayicon.cpp.

References theSolitaryBalloonTip.

{
    theSolitaryBalloonTip = 0;
}

---

Member Function Documentation

void QBalloonTip::showBalloon	(	QSystemTrayIcon::MessageIcon	icon,
		const QString &	title,
		const QString &	msg,
		QSystemTrayIcon *	trayIcon,
		const QPoint &	pos,
		int	timeout,
		bool	showArrow = true
	)			[static]

Definition at line 364 of file qsystemtrayicon.cpp.

References balloon(), hideBalloon(), message, QWidget::pos(), QBalloonTip(), theSolitaryBalloonTip, and trayIcon.

Referenced by QSystemTrayIconPrivate::showMessage_sys().

{
    hideBalloon();
    theSolitaryBalloonTip = new QBalloonTip(icon, title, message, trayIcon);
    if (timeout < 0)
        timeout = 10000; //10 s default
    theSolitaryBalloonTip->balloon(pos, timeout, showArrow);
}

Here is the call graph for this function:

void QBalloonTip::hideBalloon

(

)

[static]

Definition at line 375 of file qsystemtrayicon.cpp.

References QWidget::hide(), and theSolitaryBalloonTip.

Referenced by QSystemTrayIconPrivate::remove_sys(), and showBalloon().

{
    if (!theSolitaryBalloonTip)
        return;
    theSolitaryBalloonTip->hide();
    delete theSolitaryBalloonTip;
    theSolitaryBalloonTip = 0;
}

void QBalloonTip::balloon	(	const QPoint &	,
		int	,
		bool
	)			[private]

Definition at line 468 of file qsystemtrayicon.cpp.

References Qt::black, Qt::color0, Qt::color1, QApplication::desktop(), QPainter::drawPath(), QPixmap::fill(), QRect::height(), QSize::height(), QRect::left(), QWidget::move(), QWidget::palette(), path, pixmap, QWidget::pos(), qMax(), qMin(), QWidget::QPixmap, QRect::right(), QDesktopWidget::screenGeometry(), QPainter::setBrush(), QWidget::setContentsMargins(), QWidget::setMask(), QPainter::setPen(), QWidget::show(), QWidget::sizeHint(), QObject::startTimer(), timerId, QWidget::updateGeometry(), QRect::width(), QSize::width(), QPalette::Window, QRect::x(), QPoint::x(), and QPoint::y().

Referenced by showBalloon().

{
    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;
    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);

    // Draw the border
    pixmap = QPixmap(sz);
    QPainter painter2(&pixmap);
    painter2.setPen(QPen(Qt::black, border));
    painter2.setBrush(palette().color(QPalette::Window));
    painter2.drawPath(path);

    if (msecs > 0)
        timerId = startTimer(msecs);
    show();
}

Here is the call graph for this function:

void QBalloonTip::paintEvent

(

QPaintEvent *

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive paint events which are passed in the event parameter.

A paint event is a request to repaint all or part of the widget. It can happen as a result of repaint() or update(), or because the widget was obscured and has now been uncovered, or for many other reasons.

Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.

Qt also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, Qt merges these events into one event with a larger region (see QRegion::united()). repaint() does not permit this optimization, so we suggest using update() whenever possible.

When the paint event occurs, the update region has normally been erased, so that you're painting on the widget's background.

The background can be set using setBackgroundRole() and setPalette().

From Qt 4.0, QWidget automatically double-buffers its painting, so there's no need to write double-buffering code in paintEvent() to avoid flicker.

Note: Under X11 it is possible to toggle the global double buffering by calling qt_x11_set_global_double_buffer(). Example usage:

    ...
    extern void qt_x11_set_global_double_buffer(bool);
    qt_x11_set_global_double_buffer(false);
    ...

See also:

event(), repaint(), update(), QPainter, QPixmap, QPaintEvent, {Analog Clock Example}

Reimplemented from QWidget.

Definition at line 457 of file qsystemtrayicon.cpp.

References QPainter::drawPixmap(), pixmap, and QWidget::rect().

{
    QPainter painter(this);
    painter.drawPixmap(rect(), pixmap);
}

Here is the call graph for this function:

void QBalloonTip::resizeEvent

(

QResizeEvent *

ev

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. When resizeEvent() is called, the widget already has its new geometry. The old size is accessible through QResizeEvent::oldSize().

The widget will be erased and receive a paint event immediately after processing the resize event. No drawing need be (or should be) done inside this handler.

See also:

moveEvent(), event(), resize(), QResizeEvent, paintEvent(), {Scribble Example}

Reimplemented from QWidget.

Definition at line 463 of file qsystemtrayicon.cpp.

References QWidget::resizeEvent().

{
    QWidget::resizeEvent(ev);
}

Here is the call graph for this function:

void QBalloonTip::mousePressEvent

(

QMouseEvent *

e

)

[protected, virtual]

This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget.

If you create new widgets in the mousePressEvent() the mouseReleaseEvent() may not end up where you expect, depending on the underlying window system (or X11 window manager), the widgets' location and maybe more.

The default implementation implements the closing of popup widgets when you click outside the window. For other widget types it does nothing.

See also:

mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Definition at line 556 of file qsystemtrayicon.cpp.

References QMouseEvent::button(), QWidget::close(), emit, Qt::LeftButton, QSystemTrayIcon::messageClicked(), and trayIcon.

{
    close();
    if(e->button() == Qt::LeftButton)
        emit trayIcon->messageClicked();
}

Here is the call graph for this function:

void QBalloonTip::timerEvent

(

QTimerEvent *

e

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive timer events for the object.

QTimer provides a higher-level interface to the timer functionality, and also more general information about timers. The timer event is passed in the event parameter.

See also:

startTimer(), killTimer(), event()

Reimplemented from QObject.

Definition at line 563 of file qsystemtrayicon.cpp.

References QWidget::close(), QObject::killTimer(), QObject::timerEvent(), QTimerEvent::timerId(), timerId, and QWidget::underMouse().

{
    if (e->timerId() == timerId) {
        killTimer(timerId);
        if (!underMouse())
            close();
        return;
    }
    QWidget::timerEvent(e);
}

Here is the call graph for this function:

---

Member Data Documentation

QSystemTrayIcon* QBalloonTip::trayIcon [private]

Definition at line 96 of file qsystemtrayicon_p.h.

Referenced by mousePressEvent(), and showBalloon().

QPixmap QBalloonTip::pixmap [private]

Definition at line 97 of file qsystemtrayicon_p.h.

Referenced by balloon(), and paintEvent().

int QBalloonTip::timerId [private]

Definition at line 98 of file qsystemtrayicon_p.h.

Referenced by balloon(), and timerEvent().

---

The documentation for this class was generated from the following files:

• src/gui/util/qsystemtrayicon_p.h
• src/gui/util/qsystemtrayicon.cpp

---