X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/954b8ae60391d18b87a604e7919c87c0c6ae208b..d65c269b3f665e15a8ae1b8fff063b2ec0ef19a7:/docs/latex/wx/cursor.tex diff --git a/docs/latex/wx/cursor.tex b/docs/latex/wx/cursor.tex index f32249a792..fa34e256cb 100644 --- a/docs/latex/wx/cursor.tex +++ b/docs/latex/wx/cursor.tex @@ -24,6 +24,18 @@ global \helpref{::wxSetCursor}{wxsetcursor} is also available for MS Windows use +\wxheading{Predefined objects} + +Objects: + +{\bf wxNullCursor} + +Pointers: + +{\bf wxSTANDARD\_CURSOR\\ +wxHOURGLASS\_CURSOR\\ +wxCROSS\_CURSOR} + \wxheading{See also} \helpref{wxBitmap}{wxbitmap}, \helpref{wxIcon}{wxicon}, \helpref{wxWindow::SetCursor}{wxwindowsetcursor},\rtfsp @@ -55,6 +67,15 @@ icon file, to specify the cursor hotspot relative to the top left of the image. Constructs a cursor using a cursor identifier. +\func{}{wxCursor}{\param{const wxImage\&}{ image}} + +Constructs a cursor from a wxImage. The cursor is monochome, 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. + \func{}{wxCursor}{\param{const wxCursor\&}{ cursor}} Copy constructor. This uses reference counting so is a cheap operation. @@ -88,10 +109,10 @@ Under Windows, the permitted types are: \twocolwidtha{6cm} \begin{twocollist}\itemsep=0pt \twocolitem{\windowstyle{wxBITMAP\_TYPE\_CUR}}{Load a cursor from a .cur cursor file (only if USE\_RESOURCE\_LOADING\_IN\_MSW -is enabled in wx\_setup.h).} +is enabled in setup.h).} \twocolitem{\windowstyle{wxBITMAP\_TYPE\_CUR\_RESOURCE}}{Load a Windows resource (as specified in the .rc file).} \twocolitem{\windowstyle{wxBITMAP\_TYPE\_ICO}}{Load a cursor from a .ico icon file (only if USE\_RESOURCE\_LOADING\_IN\_MSW -is enabled in wx\_setup.h). Specify {\it hotSpotX} and {\it hotSpotY}.} +is enabled in setup.h). Specify {\it hotSpotX} and {\it hotSpotY}.} \end{twocollist}} \docparam{cursorId}{A stock cursor identifier. May be one of: @@ -99,6 +120,8 @@ is enabled in wx\_setup.h). Specify {\it hotSpotX} and {\it hotSpotY}.} \twocolwidtha{6cm} \begin{twocollist}\itemsep=0pt \twocolitem{{\bf wxCURSOR\_ARROW}}{A standard arrow cursor.} +\twocolitem{{\bf wxCURSOR\_RIGHT\_ARROW}}{A standard arrow cursor +pointing to the right.} \twocolitem{{\bf wxCURSOR\_BULLSEYE}}{Bullseye cursor.} \twocolitem{{\bf wxCURSOR\_CHAR}}{Rectangular character cursor.} \twocolitem{{\bf wxCURSOR\_CROSS}}{A cross cursor.} @@ -122,12 +145,29 @@ is enabled in wx\_setup.h). Specify {\it hotSpotX} and {\it hotSpotY}.} \twocolitem{{\bf wxCURSOR\_SPRAYCAN}}{A spraycan cursor.} \twocolitem{{\bf wxCURSOR\_WAIT}}{A wait cursor.} \twocolitem{{\bf wxCURSOR\_WATCH}}{A watch cursor.} +\twocolitem{{\bf wxCURSOR\_ARROWWAIT}}{A cursor with both an arrow and +an hourglass, (windows.)} \end{twocollist}\twocolwidtha{5cm} Note that not all cursors are available on all platforms.} \docparam{cursor}{Pointer or reference to a cursor to copy.} +\pythonnote{Constructors supported by wxPython are:\par +\indented{2cm}{\begin{twocollist} +\twocolitem{{\bf wxCursor(name, flags, hotSpotX=0, +hotSpotY=0)}}{Constructs a cursor from a filename} +\twocolitem{{\bf wxStockCursor(id)}}{Constructs a stock cursor } +\end{twocollist}} +} + +\perlnote{Contructors supported by wxPerl are:\par +\begin{itemize} +\item{Wx::Cursor->new( name, type, hotSpotX = 0, hotSpotY = 0 )} +\item{Wx::Cursor->new( id )} +\end{itemize} +} + \membersection{wxCursor::\destruct{wxCursor}} \func{}{\destruct{wxCursor}}{\void} @@ -135,7 +175,7 @@ Note that not all cursors are available on all platforms.} Destroys the cursor. A cursor can be reused for more than one window, and does not get destroyed when the window is destroyed. wxWindows destroys all cursors on application exit, although -it's best to clean them up explicitly. +it is best to clean them up explicitly. \membersection{wxCursor::Ok}\label{wxcursorok}