.. include:: headings.inc



.. _ChildFocusEvent:

==========================================================================================================================================
|phoenix_title|  **ChildFocusEvent**
==========================================================================================================================================

A child focus event is sent to a (parent-)window when one of its child windows gains focus, so that the window could restore the focus back to its corresponding child if it loses it now and regains later.          

Notice that child window is the direct child of the window receiving event. Use :meth:`Window.FindFocus`   to retrieve the window which is actually getting focus. 





.. _ChildFocusEvent-events:

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

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

- EVT_CHILD_FOCUS: Process a  ``wxEVT_CHILD_FOCUS``   event.   








         



.. seealso:: :ref:`Events and Event Handling <events and event handling>`    







|

|class_hierarchy| Inheritance Diagram
=====================================

Inheritance diagram for class **ChildFocusEvent**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/ChildFocusEvent_inheritance.png" alt="Inheritance diagram of ChildFocusEvent" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="ChildFocusEvent.html" title="A child focus event is sent to a (parent-)window when one of its child windows gains focus, so that the window could restore the focus back to its corresponding child if it loses it now and regains later." alt="" coords="429,5,573,35"/> <area shape="rect" id="node2" href="CommandEvent.html" title="This event class contains information about command events, which originate from a variety of simple controls." alt="" coords="245,5,381,35"/> <area shape="rect" id="node4" href="Event.html" title="An event is a structure holding information about an event passed to a callback or member function." alt="" coords="125,5,197,35"/> <area shape="rect" id="node5" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="5,5,77,35"/> </map> 
   </p>

|


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

================================================================================ ================================================================================
:meth:`~ChildFocusEvent.__init__`                                                Constructor.
:meth:`~ChildFocusEvent.GetWindow`                                               Returns the direct child which receives the focus, or a (grand-)parent of the control receiving the focus.
================================================================================ ================================================================================


|


|property_summary| Properties Summary
=====================================

================================================================================ ================================================================================
:attr:`~ChildFocusEvent.Window`                                                  See :meth:`~ChildFocusEvent.GetWindow`
================================================================================ ================================================================================


|


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

.. class:: ChildFocusEvent(CommandEvent)

   A child focus event is sent to a (parent-)window when one of its child windows gains focus, so that the window could restore the focus back to its corresponding child if it loses it now and regains later.
   
   **Possible constructors**::

       ChildFocusEvent(win=None)
       



   .. method:: __init__(self, win=None)

      Constructor.                  




      :param `win`: The direct child which is (or which contains the window which is) receiving the focus.   
      :type `win`: Window




                  





   .. method:: GetWindow(self)

      Returns the direct child which receives the focus, or a (grand-)parent of the control receiving the focus.                  

      To get the actually focused control use :meth:`Window.FindFocus` .                  

      :rtype: :ref:`Window`








   .. attribute:: Window

      See :meth:`~ChildFocusEvent.GetWindow`