查看源代码 wxTaskBarIcon (wx v2.4.3)

此类表示一个任务栏图标。

任务栏图标是出现在“系统托盘”中的图标,响应鼠标点击,并且可以选择在其上方显示工具提示以帮助提供信息。

X Window 系统注意事项

在 X Window 系统下,窗口管理器必须支持 freedesktop.org 的“系统托盘协议”(参见 http://freedesktop.org/wiki/Specifications/systemtray-spec)(GNOME >= 2、KDE >= 3 和 XFCE >= 4 等现代桌面环境使用的窗口管理器都支持),或者支持 GNOME 1.2 和 KDE 1 和 2 中使用的旧方法。

如果不支持,该图标将作为用户桌面上的顶层窗口出现。因为不是所有窗口管理器都有系统托盘,所以不能保证 wxTaskBarIcon 在 X Window 系统下能正常工作,因此应用程序应该只将其作为用户界面的可选组件。在 Unix 上,应该要求用户显式启用任务栏图标,默认情况下不应该启用。

此类派生自,并且可以使用以下类的函数:

wxWidgets 文档:wxTaskBarIcon

事件

此类发出的事件类型

摘要

函数

销毁对象

在当前鼠标位置弹出菜单。

移除先前使用 setIcon/3 设置的图标。

设置图标和可选的工具提示文本。

类型

-type wxTaskBarIcon() :: wx:wx_object().

函数

-spec destroy(This :: wxTaskBarIcon()) -> ok.

销毁对象

-spec new() -> wxTaskBarIcon().
-spec new([Option]) -> wxTaskBarIcon()
             when Option :: {iconType, wx:wx_enum()} | {createPopupMenu, fun(() -> wxMenu:wxMenu())}.
-spec popupMenu(This, Menu) -> boolean() when This :: wxTaskBarIcon(), Menu :: wxMenu:wxMenu().

在当前鼠标位置弹出菜单。

这些事件可以由从 wxTaskBarIcon 派生的类处理。

注意:建议重写 CreatePopupMenu() (在 wx 中未实现)回调,而不是从事件处理程序中调用此方法,因为某些端口(例如 wxCocoa)可能根本不实现 popupMenu/2 和鼠标点击事件。

-spec removeIcon(This) -> boolean() when This :: wxTaskBarIcon().

移除先前使用 setIcon/3 设置的图标。

-spec setIcon(This, Icon) -> boolean() when This :: wxTaskBarIcon(), Icon :: wxIcon:wxIcon().

等效于 setIcon(This, Icon, [])

-spec setIcon(This, Icon, [Option]) -> boolean()
                 when
                     This :: wxTaskBarIcon(),
                     Icon :: wxIcon:wxIcon(),
                     Option :: {tooltip, unicode:chardata()}.

设置图标和可选的工具提示文本。