QSystemTrayIcon类

成员函数文档

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

使用给定的parent构造一个QSystemTrayIcon对象。

图标最初是无 visible。

另请参阅visible.

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

使用给定的icon和parent构造一个QSystemTrayIcon对象。

图标最初是无 visible。

另请参阅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 可见时，会自动在系统托盘增加一个条目。

[信号] void QSystemTrayIcon::messageClicked()

当使用 showMessage() 显示的消息被用户点击时，会发出此信号。

另请参阅activated()。

void QSystemTrayIcon::setContextMenu(QMenu *menu)

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

当用户通过单击鼠标按钮请求系统托盘图标的上下文菜单时，菜单将弹出。

另请参阅：contextMenu()。

[槽函数] void QSystemTrayIcon::show()

在系统托盘显示图标。

另请参阅：hide() 和 visible。

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

显示具有给定 title、message 和 icon 的气球消息，持续时间由 millisecondsTimeoutHint 指定。 title 和 message 必须为纯文本字符串。

用户可以点击消息；当发生这种情况时，将发出 messageClicked() 信号。

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

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

在 Qt 5.2 中已将其转换为槽。

另请参阅：show() 和 supportsMessages。

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

此函数是 showMessage() 的重载。

显示具有给定 title、message 和自定义图标 icon 的气球消息，其持续时间由 millisecondsTimeoutHint 指定。

[静态] bool QSystemTrayIcon::supportsMessages()

如果系统托盘支持气球消息，则返回 true；否则返回 false。

另请参阅 showMessage。