QSystemTrayIcon Class

成员函数文档

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

根据给定的parent 创建一个QSystemTrayIcon对象。

该图标初始状态为不可见。

另请参阅 visible 。

QSystemTrayIcon::QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr)

根据给定的icon 和parent 创建一个QSystemTrayIcon对象。

该图标初始时不可见。

另请参阅 visible 。

[virtual noexcept] QSystemTrayIcon::~QSystemTrayIcon()

从系统托盘中移除图标，并释放所有已分配的资源。

[signal] void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason)

当用户激活系统托盘图标时，会触发此信号。reason 指定了激活的原因。QSystemTrayIcon::ActivationReason 列举了各种原因。

另请参阅 QSystemTrayIcon::ActivationReason 。

QMenu *QSystemTrayIcon::contextMenu() const

返回系统托盘条目当前的上下文菜单。

另请参阅 setContextMenu()。

[override virtual protected] bool QSystemTrayIcon::event(QEvent *e)

重写了：QObject::event(QEvent *e)。

QRect QSystemTrayIcon::geometry() const

返回系统托盘图标的几何形状（以屏幕坐标表示）。

另请参阅 visible 。

[slot] void QSystemTrayIcon::hide()

隐藏系统托盘图标。

另请参阅 show() 和visible 。

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

如果系统托盘可用，则返回true ；否则返回false 。

如果系统托盘当前不可用，但随后变得可用，且QSystemTrayIcon 为visible 时， 将自动在系统托盘中添加一个条目。

[signal] void QSystemTrayIcon::messageClicked()

当用户单击了通过showMessage()显示的消息时，会发出此信号。

另请参阅 activated()。

void QSystemTrayIcon::setContextMenu(QMenu *menu)

将指定的menu 设置为系统托盘图标的上下文菜单。

当用户单击鼠标按钮以调用系统托盘图标的上下文菜单时，该菜单将弹出。

另请参阅 contextMenu()。

[slot] void QSystemTrayIcon::show()

在系统托盘中显示图标。

另请参阅 hide() 和visible 。

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000)

在millisecondsTimeoutHint 中指定的时间，为具有给定title 、message 和icon 的条目显示气泡提示。title 和message 必须是纯文本字符串。

用户可以点击该消息；此时将发出messageClicked() 信号。

请注意，消息的显示取决于系统配置和用户偏好设置，因此消息可能根本不会出现。因此，不应将其作为提供关键信息的唯一手段。

在 Windows 上，当应用程序拥有焦点时，millisecondsTimeoutHint 通常会被系统忽略。

在 Qt 5.2 中已转换为插槽。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

另请参阅 show() 和supportsMessages()。

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint = 10000)

为具有给定title 、message 以及自定义图标icon 的条目显示气泡提示，显示时间为millisecondsTimeoutHint 中指定的时间。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

[static] bool QSystemTrayIcon::supportsMessages()

如果系统托盘支持气泡提示，则返回true ；否则返回false 。

另请参阅 showMessage()。