X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1058f652031c9b99daa7c701f09f16c3af7159c1..7344108e8a129a3f9b4df5ab0f98a1713db03b89:/interface/wx/cursor.h?ds=inline diff --git a/interface/wx/cursor.h b/interface/wx/cursor.h index 194db591aa..67714c5a87 100644 --- a/interface/wx/cursor.h +++ b/interface/wx/cursor.h @@ -3,7 +3,7 @@ // Purpose: interface of wxCursor // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -140,7 +140,9 @@ public: - under MacOS, it defaults to @c wxBITMAP_TYPE_MACCURSOR_RESOURCE; when specifying a string resource name, first the color cursors 'crsr' and then the black/white cursors 'CURS' in the resource chain are scanned - through. + through. Note that resource forks are deprecated on OS X so this + is only available for legacy reasons and should not be used in + new code. - under GTK, it defaults to @c wxBITMAP_TYPE_XPM. See the wxCursor(const wxImage& image) ctor for more info. - under X11, it defaults to @c wxBITMAP_TYPE_XPM. @@ -176,8 +178,15 @@ public: foreground and background. In any case, the cursor will be displayed at the size of the image. - In wxMac, if the cursor is larger than 16x16 it is resized and - currently only shown as black/white (mask respected). + Under wxMac (Cocoa), large cursors are supported. + + Notice that the @a image can define the cursor hot spot. To set it you + need to use wxImage::SetOption() with @c wxIMAGE_OPTION_CUR_HOTSPOT_X + or @c wxIMAGE_OPTION_CUR_HOTSPOT_Y, e.g. + @code + image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X, hotSpotX); + image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X, hotSpotY); + @endcode */ wxCursor(const wxImage& image);