查看源代码 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