.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2025 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc



.. _wx.MouseCaptureLostEvent:

==========================================================================================================================================
|phoenix_title|  **wx.MouseCaptureLostEvent**
==========================================================================================================================================

A mouse capture lost event is sent to a window that had obtained mouse capture, which was subsequently lost due to an "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 the capture stack (i.e. called CaptureMouse, but didn't call ReleaseMouse yet). The event is not sent if the capture changes because of a call to CaptureMouse or ReleaseMouse. 

This event is currently emitted under Windows only. 







.. _MouseCaptureLostEvent-events:

|events| Events Emitted by this Class
=====================================

Handlers bound for the following event types will receive a :ref:`wx.MouseCaptureLostEvent` parameter.

 

- EVT_MOUSE_CAPTURE_LOST: Process a  ``wxEVT_MOUSE_CAPTURE_LOST``   event.   

MSW port.  









         



.. availability:: Only available for MSW.  







.. seealso:: :ref:`wx.MouseCaptureChangedEvent`, :ref:`Events and Event Handling <events and event handling>`, :meth:`wx.Window.CaptureMouse` , :meth:`wx.Window.ReleaseMouse` , :meth:`wx.Window.GetCapture`     







|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div class="collabsible-wrapper">
      <input id="collapsible-inheritance" class="collapsible-checkbox" type="checkbox">
      <label for="collapsible-inheritance" tabindex="0" title="Show inheritance diagram" class="collapsible-label">Inheritance diagram for class <strong>MouseCaptureLostEvent</strong>:</label>
      <div class="collapsible-content">
         <p class="graphviz">
            <center><img src="_static/images/inheritance/wx.MouseCaptureLostEvent_inheritance.svg" alt="Inheritance diagram of MouseCaptureLostEvent" usemap="#dummy" class="inheritance invert-in-dark-mode"/></center>
            <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.MouseCaptureLostEvent.html" title="A mouse capture lost event is sent to a window that had obtained mouse capture, which was subsequently lost due to an 'external' event (for example, when a dialog box is shown or if another application captures the mouse)." alt="" coords="5,159,234,188"/> <area shape="rect" id="node2" href="wx.Event.html" title="An event is a structure holding information about an event passed to a callback or member function." alt="" coords="73,82,167,111"/> <area shape="rect" id="node3" href="wx.Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="70,5,169,34"/> </map> 
         </p>
      </div>
   </div>
   <script type="text/javascript" src="_static/inheritancetoggle.js"></script>



|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.MouseCaptureLostEvent.__init__`                                       Constructor.
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: wx.MouseCaptureLostEvent(Event)

   **Possible constructors**::

       MouseCaptureLostEvent(windowId=0) -> None
       
   
   A mouse capture lost event is sent to a window that had obtained mouse
   capture, which was subsequently lost due to an "external" event (for
   example, when a dialog box is shown or if another application captures
   the mouse).



   .. method:: __init__(self, windowId=0)

      Constructor. 
                 


      :param `windowId`: 
      :type `windowId`: wx.WindowID




      :rtype: `None`     







