***************************
wx.MouseCaptureChangedEvent
***************************

Inheritance diagram for `wx.MouseCaptureChangedEvent`:

|

.. inheritance-diagram:: wx.MouseCaptureChangedEvent

|

Description
===========

An mouse capture changed event is sent to a window that loses its mouse capture. This is called even if `wx.Window.ReleaseMouse <../Widgets/wx.Window.html#ReleaseMouse>`_  
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.


.. seealso:: `wx.MouseCaptureLostEvent <wx.MouseCaptureLostEvent.html>`_, `wx.Window.CaptureMouse <../Widgets/wx.Window.html#CaptureMouse>`_, 
   `wx.Window.ReleaseMouse <../Widgets/wx.Window.html#ReleaseMouse>`_,  `wx.Window.GetCapture <../Widgets/wx.Window.html#GetCapture>`_


Derived From
^^^^^^^^^^^^^

* `wx.Event <wx.Event.html>`_ 
* `wx.Object <../Widgets/wx.Object.html>`_ 


Event Handling
^^^^^^^^^^^^^^

==================================================  ==================================================  
Event Name                                          Description
==================================================  ==================================================  
wx.EVT_MOUSE_CAPTURE_CHANGED(func)                  Process a ``wx.wxEVT_MOUSE_CAPTURE_CHANGED`` event.
==================================================  ==================================================  


Methods Summary
^^^^^^^^^^^^^^^

* `__init__ <#__init__>`_ 
* `GetCapturedWindow <#GetCapturedWindow>`_ 

Properties Summary
^^^^^^^^^^^^^^^^^^

* `CapturedWindow <#CapturedWindow>`_ 

Class API
=========

Methods
^^^^^^^


.. method:: __init__(winid=0, gainedCapture=None)

   Constructor.
   
   **Parameters:**

   * `winid` (int)
   * `gainedCapture` (`wx.Window <../Widgets/wx.Window.html>`_)

   |

   **Returns:**

   `wx.MouseCaptureChangedEvent <wx.MouseCaptureChangedEvent.html>`_
 

--------

.. method:: GetCapturedWindow()

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

   |  

   **Returns:**

   `wx.Window <../Widgets/wx.Window.html>`_
 

--------

Properties
^^^^^^^^^^


.. attribute:: CapturedWindow

   See `GetCapturedWindow <#GetCapturedWindow>`_