1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
|
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Copyright (C) 2012 Klaralvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Christoph Schleifenbaum <christoph.schleifenbaum@kdab.com>
** Contact: https://www.qt.io/licensing/
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qplatformsystemtrayicon.h"
#include <QtGui/private/qguiapplication_p.h>
#include <QtGui/qpa/qplatformtheme.h>
#ifndef QT_NO_SYSTEMTRAYICON
QT_BEGIN_NAMESPACE
/*!
\class QPlatformSystemTrayIcon
\inmodule QtGui
\brief The QPlatformSystemTrayIcon class abstracts the system tray icon and interaction.
\internal
\sa QSystemTrayIcon
*/
/*!
\enum QPlatformSystemTrayIcon::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 updateIcon(), showMessage(), QMessageBox
*/
/*!
\enum QPlatformSystemTrayIcon::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()
*/
QPlatformSystemTrayIcon::QPlatformSystemTrayIcon()
{
}
QPlatformSystemTrayIcon::~QPlatformSystemTrayIcon()
{
}
/*!
\fn void QPlatformSystemTrayIcon::init()
This method is called to initialize the platform dependent implementation.
*/
/*!
\fn void QPlatformSystemTrayIcon::cleanup()
This method is called to cleanup the platform dependent implementation.
*/
/*!
\fn void QPlatformSystemTrayIcon::updateIcon(const QIcon &icon)
This method is called when the \a icon did change.
*/
/*!
\fn void QPlatformSystemTrayIcon::updateToolTip(const QString &tooltip)
This method is called when the \a tooltip text did change.
*/
/*!
\fn void QPlatformSystemTrayIcon::updateMenu(QPlatformMenu *menu)
This method is called when the system tray \a menu did change.
*/
/*!
\fn QRect QPlatformSystemTrayIcon::geometry() const
This method returns the geometry of the platform dependent system tray icon on the screen.
*/
/*!
\fn void QPlatformSystemTrayIcon::showMessage(const QString &title, const QString &msg,
const QIcon &icon, MessageIcon iconType, int msecs)
Shows a balloon message for the entry with the given \a title, message \a msg and \a icon for
the time specified in \a msecs. \a iconType is used as a hint for the implementing platform.
\sa QSystemTrayIcon::showMessage()
*/
/*!
\fn bool QPlatformSystemTrayIcon::isSystemTrayAvailable() const
Returns \c true if the system tray is available on the platform.
*/
/*!
\fn bool QPlatformSystemTrayIcon::supportsMessages() const
Returns \c true if the system tray supports messages on the platform.
*/
/*!
\fn void QPlatformSystemTrayIcon::contextMenuRequested(QPoint globalPos, const QPlatformScreen *screen)
This signal is emitted when the context menu is requested.
In particular, on platforms where createMenu() returns nullptr,
its emission will cause QSystemTrayIcon to show a QMenu-based menu.
\sa activated()
\since 5.10
*/
/*!
\fn void QPlatformSystemTrayIcon::activated(QPlatformSystemTrayIcon::ActivationReason reason)
This signal is emitted when the user activates the system tray icon.
\a reason specifies the reason for activation.
\sa QSystemTrayIcon::ActivationReason, contextMenuRequested()
*/
/*!
\fn void QPlatformSystemTrayIcon::messageClicked()
This signal is emitted when the message displayed using showMessage()
was clicked by the user.
\sa activated()
*/
/*!
This method allows platforms to use a different QPlatformMenu for system
tray menus than what would normally be used for e.g. menu bars. The default
implementation falls back to a platform menu created by the platform theme,
which may be null on platforms without native menus.
\sa updateMenu()
\since 5.3
*/
QPlatformMenu *QPlatformSystemTrayIcon::createMenu() const
{
return QGuiApplicationPrivate::platformTheme()->createPlatformMenu();
}
QT_END_NAMESPACE
#include "moc_qplatformsystemtrayicon.cpp"
#endif // QT_NO_SYSTEMTRAYICON
|