X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a0c956e8e6db05d79a7bc4757ca56fd8bd016734..f78e4942ec0f3f6abd2992502e2d6c5c2e8e55f6:/wxPython/src/_cursor.i?ds=sidebyside diff --git a/wxPython/src/_cursor.i b/wxPython/src/_cursor.i index 6ce76d4cf1..9d7e87851b 100644 --- a/wxPython/src/_cursor.i +++ b/wxPython/src/_cursor.i @@ -17,21 +17,19 @@ DocStr(wxCursor, -"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. +"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. A single cursor object may be used in many windows (any subwindow -type). The wxWindows 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.SetCursor function is also available for use -on MS Windows."); - - -RefDoc(wxCursor::wxCursor(int id), -" - Stock Cursor IDs - +type). The wxWindows 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.SetCursor` function is also available for use on MS Windows. +"," + +Stock Cursor IDs +----------------- + ======================== ====================================== wx.CURSOR_ARROW A standard arrow cursor. wx.CURSOR_RIGHT_ARROW A standard arrow cursor pointing to the right. wx.CURSOR_BLANK Transparent cursor. @@ -59,24 +57,27 @@ RefDoc(wxCursor::wxCursor(int id), wx.CURSOR_WAIT A wait cursor. wx.CURSOR_WATCH A watch cursor. wx.CURSOR_ARROWWAIT A cursor with both an arrow and an hourglass, (windows.) + ======================== ====================================== "); +MustHaveApp(wxCursor); + class wxCursor : public wxGDIObject { public: %extend { DocStr(wxCursor, - "Construct a Cursor from a file. Specify the type of file using\n" - "wx.BITAMP_TYPE* constants, and specify the hotspot if not using a\n" - ".cur file.\n" - "\n" - "This cursor is not available on wxGTK, use wx.StockCursor,\n" - "wx.CursorFromImage, or wx.CursorFromBits instead."); + "Construct a Cursor from a file. Specify the type of file using +wx.BITAMP_TYPE* constants, and specify the hotspot if not using a cur +file. + +This constructor is not available on wxGTK, use ``wx.StockCursor``, +``wx.CursorFromImage``, or ``wx.CursorFromBits`` instead.", ""); wxCursor(const wxString* cursorName, long type, int hotSpotX=0, int hotSpotY=0) { %#ifdef __WXGTK__ - wxCHECK_MSG(False, NULL, + wxCHECK_MSG(false, NULL, wxT("wx.Cursor constructor not implemented for wxGTK, use wx.StockCursor, wx.CursorFromImage, or wx.CursorFromBits instead.")); %#else return new wxCursor(*cursorName, type, hotSpotX, hotSpotY); @@ -88,33 +89,36 @@ public: DocCtorStrName( wxCursor(int id), - "Create a cursor using one of the stock cursors. Note that not\n" - "all cursors are available on all platforms.", + "Create a cursor using one of the stock cursors. Note that not all +cursors are available on all platforms.", "", StockCursor); DocCtorStrName( wxCursor(const wxImage& image), - "Constructs a cursor from a wxImage. The cursor is monochrome,\n" - "colors with the RGB elements all greater than 127 will be\n" - "foreground, colors less than this background. The mask (if any)\n" - "will be used as transparent.\n" - "\n" - "In MSW the foreground will be white and the background black. The\n" - "cursor is resized to 32x32 In GTK, the two most frequent colors\n" - "will be used for foreground and background. The cursor will be\n" - "displayed at the size of the image. On MacOS the cursor is\n" - "resized to 16x16 and currently only shown as black/white (mask\n" - "respected).", + "Constructs a cursor from a wxImage. The cursor is monochrome, colors +with the RGB elements all greater than 127 will be foreground, colors +less than this background. The mask (if any) will be used as +transparent.", +" +In MSW the foreground will be white and the background +black. The cursor is resized to 32x32. + +In GTK, the two most frequent colors will be used for foreground and +background. The cursor will be displayed at the size of the image. + +On MacOS the cursor is resized to 16x16 and currently only shown as +black/white (mask respected).", CursorFromImage); // %extend { // DocStr(wxCursor, // ""); -// %name(CursorFromBits) wxCursor(PyObject* bits, int width, int height, +// %RenameCtor(CursorFromBits, wxCursor(PyObject* bits, int width, int height, // int hotSpotX=-1, int hotSpotY=-1, -// PyObject* maskBits=NULL) { +// PyObject* maskBits=NULL)) +// { // char* bitsbuf; // char* maskbuf = NULL; // int length; @@ -130,11 +134,11 @@ public: #ifdef __WXMSW__ DocDeclStr( long , GetHandle(), - "Get the MS Windows handle for the cursor"); + "Get the MS Windows handle for the cursor", ""); %extend { DocStr(SetHandle, - "Set the MS Windows handle to use for the cursor"); + "Set the MS Windows handle to use for the cursor", ""); void SetHandle(long handle) { self->SetHandle((WXHANDLE)handle); } } @@ -142,7 +146,7 @@ public: DocDeclStr( bool , Ok(), - ""); + "", ""); %pythoncode { def __nonzero__(self): return self.Ok() } @@ -150,31 +154,31 @@ public: #ifdef __WXMSW__ DocDeclStr( int , GetWidth(), - ""); + "", ""); DocDeclStr( int , GetHeight(), - ""); + "", ""); DocDeclStr( int , GetDepth(), - ""); + "", ""); DocDeclStr( void , SetWidth(int w), - ""); + "", ""); DocDeclStr( void , SetHeight(int h), - ""); + "", ""); DocDeclStr( void , SetDepth(int d), - ""); + "", ""); DocDeclStr( void , SetSize(const wxSize& size), - ""); + "", ""); #endif