View Source wxCursor (wx v2.4.3)
A cursor is a small bitmap usually used for denoting where the mouse pointer is, with a picture that might indicate the interpretation of a mouse click.
As with icons, cursors in X and MS Windows are created in a different manner. Therefore,
separate cursors will be created for the different environments. Platform-specific methods
for creating a wxCursor
object are catered for, and this is an occasion where
conditional compilation will probably be required (see wxIcon
for an example).
A single cursor object may be used in many windows (any subwindow type). The wxWidgets
convention is to set the cursor for a window, as in X, rather than to set it globally as
in MS Windows, although a global wx_misc:setCursor/1
function is also available for MS Windows use.
Creating a Custom Cursor
The following is an example of creating a cursor from 32x32 bitmap data (down_bits) and a mask (down_mask) where 1 is black and 0 is white for the bits, and 1 is opaque and 0 is transparent for the mask. It works on Windows and GTK+.
Predefined objects (include wx.hrl):
?wxNullCursor
?wxSTANDARD_CURSOR
?wxHOURGLASS_CURSOR
?wxCROSS_CURSOR
See:
?wxStockCursor
This class is derived, and can use functions, from:
wxWidgets docs: wxCursor
Summary
Functions
Destroys the object
Returns true if cursor data is present.
Default constructor.
Constructs a cursor using a cursor identifier.
Constructs a cursor by passing a string resource name or filename.
Types
-type wxCursor() :: wx:wx_object().
Functions
-spec destroy(This :: wxCursor()) -> ok.
Destroys the object
Returns true if cursor data is present.
-spec new() -> wxCursor().
Default constructor.
-spec new(CursorName) -> wxCursor() when CursorName :: unicode:chardata(); (Image) -> wxCursor() when Image :: wxImage:wxImage() | wxCursor:wxCursor(); (CursorId) -> wxCursor() when CursorId :: wx:wx_enum().
Constructs a cursor using a cursor identifier.
-spec new(CursorName, [Option]) -> wxCursor() when CursorName :: unicode:chardata(), Option :: {type, wx:wx_enum()} | {hotSpotX, integer()} | {hotSpotY, integer()}.
Constructs a cursor by passing a string resource name or filename.
The arguments hotSpotX
and hotSpotY
are only used when there's no hotspot info in the
resource/image-file to load (e.g. when using wxBITMAP_TYPE_ICO
under wxMSW or wxBITMAP_TYPE_XPM
under wxGTK).
Equivalent to: isOk/1