X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ecb7e58c24e298af23dd2c6292df3f53538bd0a1..520200fd10b80c1d759311ed345789f5fe048ca5:/docs/latex/wx/mouseevt.tex?ds=sidebyside diff --git a/docs/latex/wx/mouseevt.tex b/docs/latex/wx/mouseevt.tex index ee5dc36b93..75cb7c3c76 100644 --- a/docs/latex/wx/mouseevt.tex +++ b/docs/latex/wx/mouseevt.tex @@ -3,10 +3,11 @@ This event class contains information about the events generated by the mouse: they include mouse buttons press and release events and mouse move events. -All mouse events involving the buttons use $1$ for the left mouse button, $2$ -for the middle one and $3$ for the right one. Note that not all mice have -a middle button so a portable application should avoid relying on the events -from it. +All mouse events involving the buttons use {\tt wxMOUSE\_BTN\_LEFT} for the +left mouse button, {\tt wxMOUSE\_BTN\_MIDDLE} for the middle one and +{\tt wxMOUSE\_BTN\_RIGHT} for the right one. Note that not all mice have a +middle button so a portable application should avoid relying on the events from +it. {\bf NB:} Note that under Windows mouse enter and leave events are not natively supported by the system but are generated by wxWindows itself. This has several @@ -16,14 +17,14 @@ time. {\bf NB:} Note the difference between methods like \helpref{LeftDown}{wxmouseeventleftdown} and -\helpref{LeftIsDown}{wxmouseeventleftisdown}: the former returns {\tt TRUE} +\helpref{LeftIsDown}{wxmouseeventleftisdown}: the former returns {\tt true} when the event corresponds to the left mouse button click while the latter -returns {\tt TRUE} if the left mouse button is currently being pressed. For +returns {\tt true} if the left mouse button is currently being pressed. For example, when the user is dragging the mouse you can use \helpref{LeftIsDown}{wxmouseeventleftisdown} to test whether the left mouse button is (still) depressed. Also, by convention, if -\helpref{LeftDown}{wxmouseeventleftdown} returns {\tt TRUE}, -\helpref{LeftIsDown}{wxmouseeventleftisdown} will also return {\tt TRUE} in +\helpref{LeftDown}{wxmouseeventleftdown} returns {\tt true}, +\helpref{LeftIsDown}{wxmouseeventleftisdown} will also return {\tt true} in wxWindows whatever the underlying GUI behaviour is (which is platform-dependent). The same applies, of course, to other mouse buttons as well. @@ -65,43 +66,43 @@ functions that take a wxMouseEvent argument. \member{bool}{m\_altDown} -TRUE if the Alt key is pressed down. +true if the Alt key is pressed down. \membersection{wxMouseEvent::m\_controlDown} \member{bool}{m\_controlDown} -TRUE if control key is pressed down. +true if control key is pressed down. \membersection{wxMouseEvent::m\_leftDown} \member{bool}{m\_leftDown} -TRUE if the left mouse button is currently pressed down. +true if the left mouse button is currently pressed down. \membersection{wxMouseEvent::m\_middleDown} \member{bool}{m\_middleDown} -TRUE if the middle mouse button is currently pressed down. +true if the middle mouse button is currently pressed down. \membersection{wxMouseEvent::m\_rightDown} \member{bool}{m\_rightDown} -TRUE if the right mouse button is currently pressed down. +true if the right mouse button is currently pressed down. \membersection{wxMouseEvent::m\_metaDown} \member{bool}{m\_metaDown} -TRUE if the Meta key is pressed down. +true if the Meta key is pressed down. \membersection{wxMouseEvent::m\_shiftDown} \member{bool}{m\_shiftDown} -TRUE if shift is pressed down. +true if shift is pressed down. \membersection{wxMouseEvent::m\_x} @@ -125,7 +126,7 @@ The distance the mouse wheel is rotated. \member{int}{m\_wheelDelta} -The wheel delta, normally 120. +The wheel delta, normally $120$. \membersection{wxMouseEvent::m\_linesPerAction} @@ -162,57 +163,72 @@ Constructor. Valid event types are: \func{bool}{AltDown}{\void} -Returns TRUE if the Alt key was down at the time of the event. +Returns true if the Alt key was down at the time of the event. -\membersection{wxMouseEvent::Button} +\membersection{wxMouseEvent::Button}\label{wxmouseeventbutton} \func{bool}{Button}{\param{int}{ button}} -Returns TRUE if the identified mouse button is changing state. Valid -values of {\it button} are 1, 2 or 3 for left, middle and right -buttons respectively. +Returns true if the identified mouse button is changing state. Valid +values of {\it button} are: -\membersection{wxMouseEvent::ButtonDClick}\label{buttondclick} +\begin{twocollist}\itemsep=0pt +\twocolitem{{\tt wxMOUSE\_BTN\_LEFT}}{check if left button was pressed} +\twocolitem{{\tt wxMOUSE\_BTN\_MIDDLE}}{check if left button was pressed} +\twocolitem{{\tt wxMOUSE\_BTN\_RIGHT}}{check if left button was pressed} +\twocolitem{{\tt wxMOUSE\_BTN\_ANY}}{check if any button was pressed} +\end{twocollist} + +\membersection{wxMouseEvent::ButtonDClick} -\func{bool}{ButtonDClick}{\param{int}{ but = -1}} +\func{bool}{ButtonDClick}{\param{int}{ but = wxMOUSE\_BTN\_ANY}} -If the argument is omitted, this returns TRUE if the event was a mouse +If the argument is omitted, this returns true if the event was a mouse double click event. Otherwise the argument specifies which double click event -was generated (1, 2 or 3 for left, middle and right buttons respectively). +was generated (see \helpref{Button}{wxmouseeventbutton} for the possible +values). \membersection{wxMouseEvent::ButtonDown} \func{bool}{ButtonDown}{\param{int}{ but = -1}} -If the argument is omitted, this returns TRUE if the event was a mouse +If the argument is omitted, this returns true if the event was a mouse button down event. Otherwise the argument specifies which button-down event -was generated (1, 2 or 3 for left, middle and right buttons respectively). +was generated (see \helpref{Button}{wxmouseeventbutton} for the possible +values). + \membersection{wxMouseEvent::ButtonUp} \func{bool}{ButtonUp}{\param{int}{ but = -1}} -If the argument is omitted, this returns TRUE if the event was a mouse +If the argument is omitted, this returns true if the event was a mouse button up event. Otherwise the argument specifies which button-up event -was generated (1, 2 or 3 for left, middle and right buttons respectively). +was generated (see \helpref{Button}{wxmouseeventbutton} for the possible +values). + \membersection{wxMouseEvent::ControlDown} \func{bool}{ControlDown}{\void} -Returns TRUE if the control key was down at the time of the event. +Returns true if the control key was down at the time of the event. -\membersection{wxMouseEvent::Dragging} +\membersection{wxMouseEvent::Dragging}\label{wxmouseeventdragging} \func{bool}{Dragging}{\void} -Returns TRUE if this was a dragging event (motion while a button is depressed). +Returns true if this was a dragging event (motion while a button is depressed). + +\wxheading{See also} + +\helpref{Moving}{wxmouseeventmoving} \membersection{wxMouseEvent::Entering}\label{wxmouseevententering} \func{bool}{Entering}{\void} -Returns TRUE if the mouse was entering the window. +Returns true if the mouse was entering the window. See also \helpref{wxMouseEvent::Leaving}{wxmouseeventleaving}. @@ -220,10 +236,11 @@ See also \helpref{wxMouseEvent::Leaving}{wxmouseeventleaving}. \constfunc{int}{GetButton}{\void} -Returns the mouse button which generated this event or $-1$ if no button is -involved (for mouse move, enter or leave event, for example). The value $1$ is -returned for the left button down, up and double click events, $2$ and $3$ for -the same events for the middle and the right buttons respectively. +Returns the mouse button which generated this event or {\tt wxMOUSE\_BTN\_NONE} +if no button is involved (for mouse move, enter or leave event, for example). +Otherwise {\tt wxMOUSE\_BTN\_LEFT} is returned for the left button down, up and +double click events, {\tt wxMOUSE\_BTN\_MIDDLE} and {\tt wxMOUSE\_BTN\_RIGHT} +for the same events for the middle and the right buttons respectively. \membersection{wxMouseEvent::GetPosition}\label{wxmouseeventgetposition} @@ -268,7 +285,7 @@ have been accumulated before scrolling. \constfunc{int}{GetWheelDelta}{\void} -Get wheel delta, normally 120. This is the threshold for action to be +Get wheel delta, normally $120$. This is the threshold for action to be taken, and one such action (for example, scrolling one increment) should occur for each delta. @@ -288,21 +305,21 @@ Returns Y coordinate of the physical mouse event position. \constfunc{bool}{IsButton}{\void} -Returns TRUE if the event was a mouse button event (not necessarily a button down event - +Returns true if the event was a mouse button event (not necessarily a button down event - that may be tested using {\it ButtonDown}). \membersection{wxMouseEvent::IsPageScroll} \constfunc{bool}{IsPageScroll}{\void} -Returns TRUE if the system has been setup to do page scrolling with +Returns true if the system has been setup to do page scrolling with the mouse wheel instead of line scrolling. \membersection{wxMouseEvent::Leaving}\label{wxmouseeventleaving} \constfunc{bool}{Leaving}{\void} -Returns TRUE if the mouse was leaving the window. +Returns true if the mouse was leaving the window. See also \helpref{wxMouseEvent::Entering}{wxmouseevententering}. @@ -310,23 +327,23 @@ See also \helpref{wxMouseEvent::Entering}{wxmouseevententering}. \constfunc{bool}{LeftDClick}{\void} -Returns TRUE if the event was a left double click. +Returns true if the event was a left double click. \membersection{wxMouseEvent::LeftDown}\label{wxmouseeventleftdown} \constfunc{bool}{LeftDown}{\void} -Returns TRUE if the left mouse button changed to down. +Returns true if the left mouse button changed to down. \membersection{wxMouseEvent::LeftIsDown}\label{wxmouseeventleftisdown} \constfunc{bool}{LeftIsDown}{\void} -Returns TRUE if the left mouse button is currently down, independent +Returns true if the left mouse button is currently down, independent of the current event type. Please notice that it is {\bf not} the same as -\helpref{LeftDown}{wxmouseeventleftdown} which returns TRUE if the left mouse +\helpref{LeftDown}{wxmouseeventleftdown} which returns true if the left mouse button was just pressed. Rather, it describes the state of the mouse button before the event happened. @@ -337,73 +354,75 @@ mouse" messages to determine whether the user is (still) dragging the mouse. \constfunc{bool}{LeftUp}{\void} -Returns TRUE if the left mouse button changed to up. +Returns true if the left mouse button changed to up. \membersection{wxMouseEvent::MetaDown} \constfunc{bool}{MetaDown}{\void} -Returns TRUE if the Meta key was down at the time of the event. +Returns true if the Meta key was down at the time of the event. \membersection{wxMouseEvent::MiddleDClick} \constfunc{bool}{MiddleDClick}{\void} -Returns TRUE if the event was a middle double click. +Returns true if the event was a middle double click. \membersection{wxMouseEvent::MiddleDown} \constfunc{bool}{MiddleDown}{\void} -Returns TRUE if the middle mouse button changed to down. +Returns true if the middle mouse button changed to down. \membersection{wxMouseEvent::MiddleIsDown}\label{wxmouseeventmiddleisdown} \constfunc{bool}{MiddleIsDown}{\void} -Returns TRUE if the middle mouse button is currently down, independent +Returns true if the middle mouse button is currently down, independent of the current event type. \membersection{wxMouseEvent::MiddleUp} \constfunc{bool}{MiddleUp}{\void} -Returns TRUE if the middle mouse button changed to up. +Returns true if the middle mouse button changed to up. -\membersection{wxMouseEvent::Moving} +\membersection{wxMouseEvent::Moving}\label{wxmouseeventmoving} \constfunc{bool}{Moving}{\void} -Returns TRUE if this was a motion event (no buttons depressed). +Returns true if this was a motion event (whether some buttons are currently +pressed or not, use \helpref{Dragging}{wxmouseeventdragging} if you need to +distinguish between these situations). \membersection{wxMouseEvent::RightDClick} \constfunc{bool}{RightDClick}{\void} -Returns TRUE if the event was a right double click. +Returns true if the event was a right double click. \membersection{wxMouseEvent::RightDown} \constfunc{bool}{RightDown}{\void} -Returns TRUE if the right mouse button changed to down. +Returns true if the right mouse button changed to down. \membersection{wxMouseEvent::RightIsDown}\label{wxmouseeventrightisdown} \constfunc{bool}{RightIsDown}{\void} -Returns TRUE if the right mouse button is currently down, independent +Returns true if the right mouse button is currently down, independent of the current event type. \membersection{wxMouseEvent::RightUp} \constfunc{bool}{RightUp}{\void} -Returns TRUE if the right mouse button changed to up. +Returns true if the right mouse button changed to up. \membersection{wxMouseEvent::ShiftDown} \constfunc{bool}{ShiftDown}{\void} -Returns TRUE if the shift key was down at the time of the event. +Returns true if the shift key was down at the time of the event.