1
/****************************************************************************
3
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
4
** Contact: http://www.qt-project.org/legal
6
** This file is part of the QtGui module of the Qt Toolkit.
8
** $QT_BEGIN_LICENSE:LGPL$
9
** Commercial License Usage
10
** Licensees holding valid commercial Qt licenses may use this file in
11
** accordance with the commercial license agreement provided with the
12
** Software or, alternatively, in accordance with the terms contained in
13
** a written agreement between you and Digia. For licensing terms and
14
** conditions see http://qt.digia.com/licensing. For further information
15
** use the contact form at http://qt.digia.com/contact-us.
17
** GNU Lesser General Public License Usage
18
** Alternatively, this file may be used under the terms of the GNU Lesser
19
** General Public License version 2.1 as published by the Free Software
20
** Foundation and appearing in the file LICENSE.LGPL included in the
21
** packaging of this file. Please review the following information to
22
** ensure the GNU Lesser General Public License version 2.1 requirements
23
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
25
** In addition, as a special exception, Digia gives you certain additional
26
** rights. These rights are described in the Digia Qt LGPL Exception
27
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
29
** GNU General Public License Usage
30
** Alternatively, this file may be used under the terms of the GNU
31
** General Public License version 3.0 as published by the Free Software
32
** Foundation and appearing in the file LICENSE.GPL included in the
33
** packaging of this file. Please review the following information to
34
** ensure the GNU General Public License version 3.0 requirements will be
35
** met: http://www.gnu.org/copyleft/gpl.html.
40
****************************************************************************/
42
#ifndef QSYSTEMTRAYICON_H
43
#define QSYSTEMTRAYICON_H
45
#include <QtCore/qobject.h>
47
#ifndef QT_NO_SYSTEMTRAYICON
49
#include <QtGui/qicon.h>
56
class QSystemTrayIconPrivate;
64
class Q_WIDGETS_EXPORT QSystemTrayIcon : public QObject
67
Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip)
68
Q_PROPERTY(QIcon icon READ icon WRITE setIcon)
69
Q_PROPERTY(bool visible READ isVisible WRITE setVisible DESIGNABLE false)
72
QSystemTrayIcon(QObject *parent = 0);
73
QSystemTrayIcon(const QIcon &icon, QObject *parent = 0);
76
enum ActivationReason {
85
void setContextMenu(QMenu *menu);
86
QMenu *contextMenu() const;
90
void setIcon(const QIcon &icon);
92
QString toolTip() const;
93
void setToolTip(const QString &tip);
95
static bool isSystemTrayAvailable();
96
static bool supportsMessages();
98
enum MessageIcon { NoIcon, Information, Warning, Critical };
99
void showMessage(const QString &title, const QString &msg,
100
MessageIcon icon = Information, int msecs = 10000);
102
QRect geometry() const;
103
bool isVisible() const;
106
void setVisible(bool visible);
107
inline void show() { setVisible(true); }
108
inline void hide() { setVisible(false); }
111
void activated(QSystemTrayIcon::ActivationReason reason);
112
void messageClicked();
115
bool event(QEvent *event);
118
Q_DISABLE_COPY(QSystemTrayIcon)
119
Q_DECLARE_PRIVATE(QSystemTrayIcon)
121
Q_PRIVATE_SLOT(d_func(), void _q_emitActivated(QPlatformSystemTrayIcon::ActivationReason))
123
friend class QSystemTrayIconSys;
124
friend class QBalloonTip;
131
#endif // QT_NO_SYSTEMTRAYICON
132
#endif // QSYSTEMTRAYICON_H