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

\section{\class{wxMouseCaptureChangedEvent}}\label{wxmousecapturechangedevent}

An mouse capture changed event is sent to a window that loses its
mouse capture. This is called even if wxWindow::ReleaseCapture
was called by the application code. Handling this event allows
an application to cater for unexpected capture releases which
might otherwise confuse mouse handling code.

This event is implemented under Windows only.

\wxheading{Derived from}

\helpref{wxEvent}{wxevent}\\
\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/event.h>

\wxheading{Library}

\helpref{wxCore}{librarieslist}

\wxheading{Event table macros}

To process this event, use the following event handler macro to direct input to a member
function that takes a wxMouseCaptureChangedEvent argument.

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_MOUSE\_CAPTURE\_CHANGED(func)}}{Process a wxEVT\_MOUSE\_CAPTURE\_CHANGED event.}
\end{twocollist}

\wxheading{See also}

\helpref{wxMouseCaptureLostEvent}{wxmousecapturelostevent}
\helpref{Event handling overview}{eventhandlingoverview}, 
\helpref{wxWindow::CaptureMouse}{wxwindowcapturemouse}, 
\helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse}, 
\helpref{wxWindow::GetCapture}{wxwindowgetcapture}

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

\membersection{wxMouseCaptureChangedEvent::wxMouseCaptureChangedEvent}\label{wxmousecapturechangedeventctor}

\func{}{wxMouseCaptureChangedEvent}{\param{wxWindowID }{windowId = 0}, \param{wxWindow*}{ gainedCapture = NULL}}

Constructor.

\membersection{wxActivateEvent::GetCapturedWindow}\label{wxmousecapturechangedeventgetcapturedwindow}

\constfunc{wxWindow*}{GetCapturedWindow}{\void}

Returns the window that gained the capture, or NULL if it was a non-wxWidgets window.


\section{\class{wxMouseCaptureLostEvent}}\label{wxmousecapturelostevent}

An mouse capture lost event is sent to a window that obtained mouse capture,
which was subsequently loss due to "external" event, for example when a dialog
box is shown or if another application captures the mouse.

If this happens, this event is sent to all windows that are on capture stack
(i.e. called CaptureMouse, but didn't call ReleaseMouse yet). The event is
{\em not} sent if the capture changes because of a call to CaptureMouse or
ReleaseMouse.

This event is currently emitted under Windows only.

\wxheading{Derived from}

\helpref{wxEvent}{wxevent}\\
\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/event.h>

\wxheading{Library}

\helpref{wxCore}{librarieslist}

\wxheading{Event table macros}

To process this event, use the following event handler macro to direct input to
a member function that takes a wxMouseCaptureLostEvent argument.

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_MOUSE\_CAPTURE\_LOST(func)}}{Process a wxEVT\_MOUSE\_CAPTURE\_LOST event.}
\end{twocollist}

\wxheading{See also}

\helpref{wxMouseCaptureChangedEvent}{wxmousecapturechangedevent}
\helpref{Event handling overview}{eventhandlingoverview}, 
\helpref{wxWindow::CaptureMouse}{wxwindowcapturemouse}, 
\helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse}, 
\helpref{wxWindow::GetCapture}{wxwindowgetcapture}

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

\membersection{wxMouseCaptureLostEvent::wxMouseCaptureLostEvent}\label{wxmousecapturelosteventctor}

\func{}{wxMouseCaptureLostEvent}{\param{wxWindowID }{windowId = 0}}

Constructor.
Commit	Line	Data
a5e84126 JS	1	\section{\class{wxMouseCaptureChangedEvent}}\label{wxmousecapturechangedevent}
	2
	3	An mouse capture changed event is sent to a window that loses its
	4	mouse capture. This is called even if wxWindow::ReleaseCapture
	5	was called by the application code. Handling this event allows
	6	an application to cater for unexpected capture releases which
	7	might otherwise confuse mouse handling code.
	8
	9	This event is implemented under Windows only.
	10
	11	\wxheading{Derived from}
	12
	13	\helpref{wxEvent}{wxevent}\\
	14	\helpref{wxObject}{wxobject}
	15
	16	\wxheading{Include files}
	17
	18	<wx/event.h>
	19
a7af285d VZ	20	\wxheading{Library}
	21
	22	\helpref{wxCore}{librarieslist}
	23
a5e84126 JS	24	\wxheading{Event table macros}
	25
	26	To process this event, use the following event handler macro to direct input to a member
	27	function that takes a wxMouseCaptureChangedEvent argument.
	28
	29	\twocolwidtha{7cm}
	30	\begin{twocollist}\itemsep=0pt
	31	\twocolitem{{\bf EVT\_MOUSE\_CAPTURE\_CHANGED(func)}}{Process a wxEVT\_MOUSE\_CAPTURE\_CHANGED event.}
d2c2afc9	32	\end{twocollist}
a5e84126 JS	33
	34	\wxheading{See also}
	35
63e819f2	36	\helpref{wxMouseCaptureLostEvent}{wxmousecapturelostevent}
a5e84126 JS	37	\helpref{Event handling overview}{eventhandlingoverview},
	38	\helpref{wxWindow::CaptureMouse}{wxwindowcapturemouse},
	39	\helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse},
	40	\helpref{wxWindow::GetCapture}{wxwindowgetcapture}
	41
	42	\latexignore{\rtfignore{\wxheading{Members}}}
	43
3e79fa75	44	\membersection{wxMouseCaptureChangedEvent::wxMouseCaptureChangedEvent}\label{wxmousecapturechangedeventctor}
a5e84126 JS	45
	46	\func{}{wxMouseCaptureChangedEvent}{\param{wxWindowID }{windowId = 0}, \param{wxWindow*}{ gainedCapture = NULL}}
	47
	48	Constructor.
	49
	50	\membersection{wxActivateEvent::GetCapturedWindow}\label{wxmousecapturechangedeventgetcapturedwindow}
	51
	52	\constfunc{wxWindow*}{GetCapturedWindow}{\void}
	53
fc2171bd	54	Returns the window that gained the capture, or NULL if it was a non-wxWidgets window.
a5e84126	55
63e819f2 VS	56
	57	\section{\class{wxMouseCaptureLostEvent}}\label{wxmousecapturelostevent}
	58
	59	An mouse capture lost event is sent to a window that obtained mouse capture,
	60	which was subsequently loss due to "external" event, for example when a dialog
	61	box is shown or if another application captures the mouse.
	62
	63	If this happens, this event is sent to all windows that are on capture stack
	64	(i.e. called CaptureMouse, but didn't call ReleaseMouse yet). The event is
	65	{\em not} sent if the capture changes because of a call to CaptureMouse or
	66	ReleaseMouse.
	67
	68	This event is currently emitted under Windows only.
	69
	70	\wxheading{Derived from}
	71
	72	\helpref{wxEvent}{wxevent}\\
	73	\helpref{wxObject}{wxobject}
	74
	75	\wxheading{Include files}
	76
	77	<wx/event.h>
	78
a7af285d VZ	79	\wxheading{Library}
	80
	81	\helpref{wxCore}{librarieslist}
	82
63e819f2 VS	83	\wxheading{Event table macros}
	84
	85	To process this event, use the following event handler macro to direct input to
	86	a member function that takes a wxMouseCaptureLostEvent argument.
	87
	88	\twocolwidtha{7cm}
	89	\begin{twocollist}\itemsep=0pt
	90	\twocolitem{{\bf EVT\_MOUSE\_CAPTURE\_LOST(func)}}{Process a wxEVT\_MOUSE\_CAPTURE\_LOST event.}
	91	\end{twocollist}
	92
	93	\wxheading{See also}
	94
	95	\helpref{wxMouseCaptureChangedEvent}{wxmousecapturechangedevent}
	96	\helpref{Event handling overview}{eventhandlingoverview},
	97	\helpref{wxWindow::CaptureMouse}{wxwindowcapturemouse},
	98	\helpref{wxWindow::ReleaseMouse}{wxwindowreleasemouse},
	99	\helpref{wxWindow::GetCapture}{wxwindowgetcapture}
	100
	101	\latexignore{\rtfignore{\wxheading{Members}}}
	102
	103	\membersection{wxMouseCaptureLostEvent::wxMouseCaptureLostEvent}\label{wxmousecapturelosteventctor}
	104
	105	\func{}{wxMouseCaptureLostEvent}{\param{wxWindowID }{windowId = 0}}
	106
	107	Constructor.
b67a86d5	108