mouseevt.tex

来自「Wxpython Implemented on Windows CE, Sou」· TEX 代码 · 共 495 行 · 第 1/2 页

\section{\class{wxMouseEvent}}\label{wxmouseevent}

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 {\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 CE mouse enter and leave events are not natively supported
by the system but are generated by wxWidgets itself. This has several
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.

{\bf NB:} Note the difference between methods like
\helpref{LeftDown}{wxmouseeventleftdown} and
\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
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
wxWidgets 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{Include files}

<wx/event.h>

\wxheading{Event table macros}

To process a mouse event, use these event handler macros to direct input to member
functions that take a wxMouseEvent argument.

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_LEFT\_DOWN(func)}}{Process a wxEVT\_LEFT\_DOWN event. The
handler of this event should normally call \helpref{event.Skip()}{wxeventskip} to
allow the default processing to take place as otherwise the window under mouse
wouldn't get the focus.}
\twocolitem{{\bf EVT\_LEFT\_UP(func)}}{Process a wxEVT\_LEFT\_UP event.}
\twocolitem{{\bf EVT\_LEFT\_DCLICK(func)}}{Process a wxEVT\_LEFT\_DCLICK event.}
\twocolitem{{\bf EVT\_MIDDLE\_DOWN(func)}}{Process a wxEVT\_MIDDLE\_DOWN event.}
\twocolitem{{\bf EVT\_MIDDLE\_UP(func)}}{Process a wxEVT\_MIDDLE\_UP event.}
\twocolitem{{\bf EVT\_MIDDLE\_DCLICK(func)}}{Process a wxEVT\_MIDDLE\_DCLICK event.}
\twocolitem{{\bf EVT\_RIGHT\_DOWN(func)}}{Process a wxEVT\_RIGHT\_DOWN event.}
\twocolitem{{\bf EVT\_RIGHT\_UP(func)}}{Process a wxEVT\_RIGHT\_UP event.}
\twocolitem{{\bf EVT\_RIGHT\_DCLICK(func)}}{Process a wxEVT\_RIGHT\_DCLICK event.}
\twocolitem{{\bf EVT\_MOTION(func)}}{Process a wxEVT\_MOTION event.}
\twocolitem{{\bf EVT\_ENTER\_WINDOW(func)}}{Process a wxEVT\_ENTER\_WINDOW event.}
\twocolitem{{\bf EVT\_LEAVE\_WINDOW(func)}}{Process a wxEVT\_LEAVE\_WINDOW event.}
\twocolitem{{\bf EVT\_MOUSEWHEEL(func)}}{Process a wxEVT\_MOUSEWHEEL event.}
\twocolitem{{\bf EVT\_MOUSE\_EVENTS(func)}}{Process all mouse events.}
\end{twocollist}%

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxMouseEvent::m\_altDown}\label{wxmouseeventmaltdown}

\member{bool}{m\_altDown}

true if the Alt key is pressed down.


\membersection{wxMouseEvent::m\_controlDown}\label{wxmouseeventmcontroldown}

\member{bool}{m\_controlDown}

true if control key is pressed down.


\membersection{wxMouseEvent::m\_leftDown}\label{wxmouseeventmleftdown}

\member{bool}{m\_leftDown}

true if the left mouse button is currently pressed down.


\membersection{wxMouseEvent::m\_middleDown}\label{wxmouseeventmmiddledown}

\member{bool}{m\_middleDown}

true if the middle mouse button is currently pressed down.


\membersection{wxMouseEvent::m\_rightDown}\label{wxmouseeventmrightdown}

\member{bool}{m\_rightDown}

true if the right mouse button is currently pressed down.


\membersection{wxMouseEvent::m\_metaDown}\label{wxmouseeventmmetadown}

\member{bool}{m\_metaDown}

true if the Meta key is pressed down.


\membersection{wxMouseEvent::m\_shiftDown}\label{wxmouseeventmshiftdown}

\member{bool}{m\_shiftDown}

true if shift is pressed down.


\membersection{wxMouseEvent::m\_x}\label{wxmouseeventmx}

\member{long}{m\_x}

X-coordinate of the event.


\membersection{wxMouseEvent::m\_y}\label{wxmouseeventmy}

\member{long}{m\_y}

Y-coordinate of the event.


\membersection{wxMouseEvent::m\_wheelRotation}\label{wxmouseeventmwheelrotation}

\member{int}{m\_wheelRotation}

The distance the mouse wheel is rotated.


\membersection{wxMouseEvent::m\_wheelDelta}\label{wxmouseeventmwheeldelta}

\member{int}{m\_wheelDelta}

The wheel delta, normally $120$.


\membersection{wxMouseEvent::m\_linesPerAction}\label{wxmouseeventmlinesperaction}

\member{int}{m\_linesPerAction}

The configured number of lines (or whatever) to be scrolled per wheel
action.



\membersection{wxMouseEvent::wxMouseEvent}\label{wxmouseeventctor}

\func{}{wxMouseEvent}{\param{WXTYPE}{ mouseEventType = 0}}

Constructor. Valid event types are:

\begin{itemize}
\itemsep=0pt
\item {\bf wxEVT\_ENTER\_WINDOW}
\item {\bf wxEVT\_LEAVE\_WINDOW}
\item {\bf wxEVT\_LEFT\_DOWN}
\item {\bf wxEVT\_LEFT\_UP}
\item {\bf wxEVT\_LEFT\_DCLICK}
\item {\bf wxEVT\_MIDDLE\_DOWN}
\item {\bf wxEVT\_MIDDLE\_UP}
\item {\bf wxEVT\_MIDDLE\_DCLICK}
\item {\bf wxEVT\_RIGHT\_DOWN}
\item {\bf wxEVT\_RIGHT\_UP}
\item {\bf wxEVT\_RIGHT\_DCLICK}
\item {\bf wxEVT\_MOTION}
\item {\bf wxEVT\_MOUSEWHEEL}
\end{itemize}


\membersection{wxMouseEvent::AltDown}\label{wxmouseeventaltdown}

\func{bool}{AltDown}{\void}

Returns true if the Alt key was down at the time of the event.


\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:

\begin{twocollist}\itemsep=0pt
\twocolitem{{\tt wxMOUSE\_BTN\_LEFT}}{check if left button was pressed}
\twocolitem{{\tt wxMOUSE\_BTN\_MIDDLE}}{check if middle button was pressed}
\twocolitem{{\tt wxMOUSE\_BTN\_RIGHT}}{check if right button was pressed}
\twocolitem{{\tt wxMOUSE\_BTN\_ANY}}{check if any button was pressed}
\end{twocollist}


\membersection{wxMouseEvent::ButtonDClick}\label{wxmouseeventbuttondclick}

\func{bool}{ButtonDClick}{\param{int}{ but = wxMOUSE\_BTN\_ANY}}

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 (see \helpref{Button}{wxmouseeventbutton} for the possible
values).


\membersection{wxMouseEvent::ButtonDown}\label{wxmouseeventbuttondown}

\func{bool}{ButtonDown}{\param{int}{ but = -1}}

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 (see \helpref{Button}{wxmouseeventbutton} for the possible
values).



\membersection{wxMouseEvent::ButtonUp}\label{wxmouseeventbuttonup}

\func{bool}{ButtonUp}{\param{int}{ but = -1}}

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 (see \helpref{Button}{wxmouseeventbutton} for the possible
values).



\membersection{wxMouseEvent::CmdDown}\label{wxmouseeventcmddown}

\constfunc{bool}{CmdDown}{\void}

Same as \helpref{MetaDown}{wxmouseeventmetadown} under Mac, same as 
\helpref{ControlDown}{wxmouseeventcontroldown} elsewhere.

\wxheading{See also}

\helpref{wxKeyEvent::CmdDown}{wxkeyeventcmddown}


\membersection{wxMouseEvent::ControlDown}\label{wxmouseeventcontroldown}

\func{bool}{ControlDown}{\void}