X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/eaaa6a06a25774c18d10bb8182cc1934ed0ed9aa..afbe906abdf9aa69a56571b8b20b095351dd8f34:/docs/latex/wx/cursor.tex diff --git a/docs/latex/wx/cursor.tex b/docs/latex/wx/cursor.tex index ebe20a9803..44e28edc18 100644 --- a/docs/latex/wx/cursor.tex +++ b/docs/latex/wx/cursor.tex @@ -20,6 +20,22 @@ global \helpref{::wxSetCursor}{wxsetcursor} is also available for MS Windows use \helpref{wxGDIObject}{wxgdiobject}\\ \helpref{wxObject}{wxobject} +\wxheading{Include files} + + + +\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 @@ -51,11 +67,16 @@ 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 wxCursor\&}{ cursor}} +\func{}{wxCursor}{\param{const wxImage\&}{ image}} -Copy constructor. This uses reference counting so is a cheap operation. +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. -\func{}{wxCursor}{\param{const wxCursor*}{ cursor}} +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: @@ -122,12 +143,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 +173,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}