docs/latex/wx/mcaptevt.tex

   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
  20 \wxheading{Library}
  21
  22 \helpref{wxCore}{librarieslist}
  23
  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.}
  32 \end{twocollist}
  33
  34 \wxheading{See also}
  35
  36 \helpref{wxMouseCaptureLostEvent}{wxmousecapturelostevent}
  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
  44 \membersection{wxMouseCaptureChangedEvent::wxMouseCaptureChangedEvent}\label{wxmousecapturechangedeventctor}
  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
  54 Returns the window that gained the capture, or NULL if it was a non-wxWidgets window.
  55
  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
  79 \wxheading{Library}
  80
  81 \helpref{wxCore}{librarieslist}
  82
  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.
 108