檢視原始碼 wxCursor (wx v2.4.3)

游標是一個小的點陣圖,通常用於表示滑鼠指標的位置,其圖片可能表示滑鼠點擊的含義。

與圖示一樣,在 X 和 MS Windows 中,游標的建立方式不同。因此,將為不同的環境建立不同的游標。提供了建立 wxCursor 物件的平台特定方法,這是一個可能需要條件編譯的情況(請參閱 wxIcon 以取得範例)。

單個游標物件可以被許多視窗(任何子視窗類型)使用。wxWidgets 的慣例是為視窗設定游標,如同 X 系統,而不是像 MS Windows 那樣全域設定,儘管也為 MS Windows 用戶提供了全域的 wx_misc:setCursor/1 函數。

建立自訂游標

以下是從 32x32 位元圖資料 (down_bits) 和遮罩 (down_mask) 建立游標的範例,其中位元 1 代表黑色,0 代表白色,遮罩 1 代表不透明,0 代表透明。它適用於 Windows 和 GTK+。

預定義物件(包含 wx.hrl)

  • ?wxNullCursor

  • ?wxSTANDARD_CURSOR

  • ?wxHOURGLASS_CURSOR

  • ?wxCROSS_CURSOR

參見

此類別繼承自以下類別,並可以使用其函數:

wxWidgets 文件:wxCursor

摘要

函數

銷毀物件

如果存在游標資料,則傳回 true。

預設建構函式。

使用游標識別碼建構游標。

透過傳遞字串資源名稱或檔案名稱來建構游標。

等同於:isOk/1

類型

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

函數

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

銷毀物件

-spec isOk(This) -> boolean() when This :: wxCursor().

如果存在游標資料,則傳回 true。

-spec new() -> wxCursor().

預設建構函式。

-spec new(CursorName) -> wxCursor() when CursorName :: unicode:chardata();
         (Image) -> wxCursor() when Image :: wxImage:wxImage() | wxCursor:wxCursor();
         (CursorId) -> wxCursor() when CursorId :: wx:wx_enum().

使用游標識別碼建構游標。

連結到此函數

new(CursorName, Options)

檢視原始碼
-spec new(CursorName, [Option]) -> wxCursor()
             when
                 CursorName :: unicode:chardata(),
                 Option :: {type, wx:wx_enum()} | {hotSpotX, integer()} | {hotSpotY, integer()}.

透過傳遞字串資源名稱或檔案名稱來建構游標。

僅當資源/影像檔案中沒有要載入的熱點資訊時,才會使用引數 hotSpotXhotSpotY(例如,在 wxMSW 下使用 wxBITMAP_TYPE_ICO 或在 wxGTK 下使用 wxBITMAP_TYPE_XPM 時)。

-spec ok(This) -> boolean() when This :: wxCursor().

等同於:isOk/1