fixed bug in mouse handling

[wxWidgets.git] / docs / latex / wx / mouseevt.tex

diff --git a/docs/latex/wx/mouseevt.tex b/docs/latex/wx/mouseevt.tex
index 04345f219251dba6e7f8ea9b9d05fb7a93c41c93..423811a297d65b1094248c72d7ca3bb8cc331f65 100644 (file)
--- a/docs/latex/wx/mouseevt.tex
+++ b/docs/latex/wx/mouseevt.tex
@@ -9,6 +9,20 @@ drawbacks: the LEAVE\_WINDOW event might be received some time after the mouse
 left the window and the state variables for it may have changed during this
 time.
 
 left the window and the state variables for it may have changed during this
 time.
 

+{\bf NB: } Note the difference between methods like 
+\helpref{LeftDown}{wxmouseeventleftdown} and 
+\helpref{LeftIsDown}{wxmouseeventleftisdown}: the formet 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
+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
+wxWindows whatever the underlying GUI behaviour is (which is
+platform-dependent). The same applies, of course, to other mouse buttons as
+well.
+

 \wxheading{Derived from}
 
 \helpref{wxEvent}{wxevent}
 \wxheading{Derived from}
 
 \helpref{wxEvent}{wxevent}


@@ -180,7 +194,7 @@ Returns TRUE if this was a dragging event (motion while a button is depressed).
 
 \func{bool}{Entering}{\void}
 
 
 \func{bool}{Entering}{\void}
 

-Returns TRUE if the mouse was entering the window (MS Windows and Motif).
+Returns TRUE if the mouse was entering the window.

 
 See also \helpref{wxMouseEvent::Leaving}{wxmouseeventleaving}.
 
 
 See also \helpref{wxMouseEvent::Leaving}{wxmouseeventleaving}.
 


@@ -188,7 +202,9 @@ See also \helpref{wxMouseEvent::Leaving}{wxmouseeventleaving}.
 
 \constfunc{wxPoint}{GetPosition}{\void}
 
 
 \constfunc{wxPoint}{GetPosition}{\void}
 

-\constfunc{void}{GetPosition}{\param{long *}{x}, \param{long *}{y}}
+\constfunc{void}{GetPosition}{\param{wxCoord*}{ x}, \param{wxCoord*}{ y}}
+
+\constfunc{void}{GetPosition}{\param{long*}{ x}, \param{long*}{ y}}

 
 Sets *x and *y to the position at which the event occurred.
 
 
 Sets *x and *y to the position at which the event occurred.
 


@@ -224,7 +240,7 @@ that may be tested using {\it ButtonDown}).
 
 \constfunc{bool}{Leaving}{\void}
 
 
 \constfunc{bool}{Leaving}{\void}
 

-Returns TRUE if the mouse was leaving the window (MS Windows and Motif).
+Returns TRUE if the mouse was leaving the window.

 
 See also \helpref{wxMouseEvent::Entering}{wxmouseevententering}.
 
 
 See also \helpref{wxMouseEvent::Entering}{wxmouseevententering}.
 


@@ -240,7 +256,7 @@ Returns TRUE if the event was a left double click.
 
 Returns TRUE if the left mouse button changed to down.
 
 
 Returns TRUE if the left mouse button changed to down.
 

-\membersection{wxMouseEvent::LeftIsDown}
+\membersection{wxMouseEvent::LeftIsDown}\label{wxmouseeventleftisdown}

 
 \constfunc{bool}{LeftIsDown}{\void}
 
 
 \constfunc{bool}{LeftIsDown}{\void}
 


@@ -279,7 +295,7 @@ Returns TRUE if the event was a middle double click.
 
 Returns TRUE if the middle mouse button changed to down.
 
 
 Returns TRUE if the middle mouse button changed to down.
 

-\membersection{wxMouseEvent::MiddleIsDown}
+\membersection{wxMouseEvent::MiddleIsDown}\label{wxmouseeventmiddleisdown}

 
 \constfunc{bool}{MiddleIsDown}{\void}
 
 
 \constfunc{bool}{MiddleIsDown}{\void}
 


@@ -310,7 +326,7 @@ Returns TRUE if the event was a right double click.
 
 Returns TRUE if the right mouse button changed to down.
 
 
 Returns TRUE if the right mouse button changed to down.
 

-\membersection{wxMouseEvent::RightIsDown}
+\membersection{wxMouseEvent::RightIsDown}\label{wxmouseeventrightisdown}

 
 \constfunc{bool}{RightIsDown}{\void}
 
 
 \constfunc{bool}{RightIsDown}{\void}