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

\section{\class{wxJoystickEvent}}\label{wxjoystickevent}

This event class contains information about mouse events, particularly
events received by windows.

\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 wxJoystickEvent argument.

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_JOY\_BUTTON\_DOWN(func)}}{Process a wxEVT\_JOY\_BUTTON\_DOWN event.}
\twocolitem{{\bf EVT\_JOY\_BUTTON\_UP(func)}}{Process a wxEVT\_JOY\_BUTTON\_UP event.}
\twocolitem{{\bf EVT\_JOY\_MOVE(func)}}{Process a wxEVT\_JOY\_MOVE event.}
\twocolitem{{\bf EVT\_JOY\_ZMOVE(func)}}{Process a wxEVT\_JOY\_ZMOVE event.}
\end{twocollist}%

\wxheading{See also}

\helpref{wxJoystick}{wxjoystick}

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

\membersection{wxJoystickEvent::wxJoystickEvent}\label{wxjoystickeventctor}

\func{}{wxJoystickEvent}{\param{WXTYPE}{ eventType = 0}, \param{int}{ state = 0},
 \param{int}{ joystick = wxJOYSTICK1}, \param{int }{change = 0}}

Constructor.

\membersection{wxJoystickEvent::ButtonDown}\label{wxjoystickeventbuttondown}

\constfunc{bool}{ButtonDown}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}

Returns true if the event was a down event from the specified button (or any button).

\wxheading{Parameters}

\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
indicate any button down event.}

\membersection{wxJoystickEvent::ButtonIsDown}\label{wxjoystickeventbuttonisdown}

\constfunc{bool}{ButtonIsDown}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}

Returns true if the specified button (or any button) was in a down state.

\wxheading{Parameters}

\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
indicate any button down event.}

\membersection{wxJoystickEvent::ButtonUp}\label{wxjoystickeventbuttonup}

\constfunc{bool}{ButtonUp}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}

Returns true if the event was an up event from the specified button (or any button).

\wxheading{Parameters}

\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
indicate any button down event.}

\membersection{wxJoystickEvent::GetButtonChange}\label{wxjoystickeventgetbuttonchange}

\constfunc{int}{GetButtonChange}{\void}

Returns the identifier of the button changing state. This is a wxJOY\_BUTTONn identifier, where
n is one of 1, 2, 3, 4.

\membersection{wxJoystickEvent::GetButtonState}\label{wxjoystickeventgetbuttonstate}

\constfunc{int}{GetButtonState}{\void}

Returns the down state of the buttons. This is a bitlist of wxJOY\_BUTTONn identifiers, where
n is one of 1, 2, 3, 4.

\membersection{wxJoystickEvent::GetJoystick}\label{wxjoystickeventgetjoystick}

\constfunc{int}{GetJoystick}{\void}

Returns the identifier of the joystick generating the event - one of wxJOYSTICK1 and wxJOYSTICK2.

\membersection{wxJoystickEvent::GetPosition}\label{wxjoystickeventgetposition}

\constfunc{wxPoint}{GetPosition}{\void}

Returns the x, y position of the joystick event.

\membersection{wxJoystickEvent::GetZPosition}\label{wxjoystickeventgetzposition}

\constfunc{int}{GetZPosition}{\void}

Returns the z position of the joystick event.

\membersection{wxJoystickEvent::IsButton}\label{wxjoystickeventisbutton}

\constfunc{bool}{IsButton}{\void}

Returns true if this was a button up or down event ({\it not} 'is any button down?').

\membersection{wxJoystickEvent::IsMove}\label{wxjoystickeventismove}

\constfunc{bool}{IsMove}{\void}

Returns true if this was an x, y move event.

\membersection{wxJoystickEvent::IsZMove}\label{wxjoystickeventiszmove}

\constfunc{bool}{IsZMove}{\void}

Returns true if this was a z move event.
Commit	Line	Data
fe604ccd JS	1	\section{\class{wxJoystickEvent}}\label{wxjoystickevent}
	2
	3	This event class contains information about mouse events, particularly
	4	events received by windows.
	5
	6	\wxheading{Derived from}
	7
	8	\helpref{wxEvent}{wxevent}
	9
954b8ae6 JS	10	\wxheading{Include files}
	11
	12	<wx/event.h>
	13
fe604ccd JS	14	\wxheading{Event table macros}
	15
	16	To process a mouse event, use these event handler macros to direct input to member
	17	functions that take a wxJoystickEvent argument.
	18
	19	\twocolwidtha{7cm}
	20	\begin{twocollist}\itemsep=0pt
	21	\twocolitem{{\bf EVT\_JOY\_BUTTON\_DOWN(func)}}{Process a wxEVT\_JOY\_BUTTON\_DOWN event.}
	22	\twocolitem{{\bf EVT\_JOY\_BUTTON\_UP(func)}}{Process a wxEVT\_JOY\_BUTTON\_UP event.}
	23	\twocolitem{{\bf EVT\_JOY\_MOVE(func)}}{Process a wxEVT\_JOY\_MOVE event.}
	24	\twocolitem{{\bf EVT\_JOY\_ZMOVE(func)}}{Process a wxEVT\_JOY\_ZMOVE event.}
	25	\end{twocollist}%
	26
	27	\wxheading{See also}
	28
	29	\helpref{wxJoystick}{wxjoystick}
	30
	31	\latexignore{\rtfignore{\wxheading{Members}}}
	32
f0e8a2d0	33	\membersection{wxJoystickEvent::wxJoystickEvent}\label{wxjoystickeventctor}
fe604ccd JS	34
	35	\func{}{wxJoystickEvent}{\param{WXTYPE}{ eventType = 0}, \param{int}{ state = 0},
	36	\param{int}{ joystick = wxJOYSTICK1}, \param{int }{change = 0}}
	37
	38	Constructor.
	39
	40	\membersection{wxJoystickEvent::ButtonDown}\label{wxjoystickeventbuttondown}
	41
	42	\constfunc{bool}{ButtonDown}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}
	43
cc81d32f	44	Returns true if the event was a down event from the specified button (or any button).
fe604ccd JS	45
	46	\wxheading{Parameters}
	47
	48	\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
	49	indicate any button down event.}
	50
	51	\membersection{wxJoystickEvent::ButtonIsDown}\label{wxjoystickeventbuttonisdown}
	52
	53	\constfunc{bool}{ButtonIsDown}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}
	54
cc81d32f	55	Returns true if the specified button (or any button) was in a down state.
fe604ccd JS	56
	57	\wxheading{Parameters}
	58
	59	\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
	60	indicate any button down event.}
	61
	62	\membersection{wxJoystickEvent::ButtonUp}\label{wxjoystickeventbuttonup}
	63
	64	\constfunc{bool}{ButtonUp}{\param{int}{ button = wxJOY\_BUTTON\_ANY}}
	65
cc81d32f	66	Returns true if the event was an up event from the specified button (or any button).
fe604ccd JS	67
	68	\wxheading{Parameters}
	69
	70	\docparam{button}{Can be wxJOY\_BUTTONn where n is 1, 2, 3 or 4; or wxJOY\_BUTTON\_ANY to
	71	indicate any button down event.}
	72
	73	\membersection{wxJoystickEvent::GetButtonChange}\label{wxjoystickeventgetbuttonchange}
	74
	75	\constfunc{int}{GetButtonChange}{\void}
	76
	77	Returns the identifier of the button changing state. This is a wxJOY\_BUTTONn identifier, where
	78	n is one of 1, 2, 3, 4.
	79
	80	\membersection{wxJoystickEvent::GetButtonState}\label{wxjoystickeventgetbuttonstate}
	81
	82	\constfunc{int}{GetButtonState}{\void}
	83
	84	Returns the down state of the buttons. This is a bitlist of wxJOY\_BUTTONn identifiers, where
	85	n is one of 1, 2, 3, 4.
	86
	87	\membersection{wxJoystickEvent::GetJoystick}\label{wxjoystickeventgetjoystick}
	88
	89	\constfunc{int}{GetJoystick}{\void}
	90
	91	Returns the identifier of the joystick generating the event - one of wxJOYSTICK1 and wxJOYSTICK2.
	92
	93	\membersection{wxJoystickEvent::GetPosition}\label{wxjoystickeventgetposition}
	94
	95	\constfunc{wxPoint}{GetPosition}{\void}
	96
	97	Returns the x, y position of the joystick event.
	98
	99	\membersection{wxJoystickEvent::GetZPosition}\label{wxjoystickeventgetzposition}
	100
	101	\constfunc{int}{GetZPosition}{\void}
	102
	103	Returns the z position of the joystick event.
	104
	105	\membersection{wxJoystickEvent::IsButton}\label{wxjoystickeventisbutton}
	106
	107	\constfunc{bool}{IsButton}{\void}
	108
cc81d32f	109	Returns true if this was a button up or down event ({\it not} 'is any button down?').
fe604ccd JS	110
	111	\membersection{wxJoystickEvent::IsMove}\label{wxjoystickeventismove}
	112
	113	\constfunc{bool}{IsMove}{\void}
	114
cc81d32f	115	Returns true if this was an x, y move event.
fe604ccd JS	116
	117	\membersection{wxJoystickEvent::IsZMove}\label{wxjoystickeventiszmove}
	118
	119	\constfunc{bool}{IsZMove}{\void}
	120
cc81d32f	121	Returns true if this was a z move event.
fe604ccd	122