檢視原始碼 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()}.

設定圖示和可選的工具提示文字。