.. include:: headings.inc

.. currentmodule:: lib.activex

.. highlight:: python



.. _lib.activex.ActiveXCtrl:

==========================================================================================================================================
|phoenix_title|  **ActiveXCtrl**
==========================================================================================================================================

A wx.Window for hosting ActiveX controls.  The COM interface of
the ActiveX control is accessible through the ctrl property of
this class, and this class is also set as the event sink for COM
events originating from the ActiveX control.  In other words, to
catch the COM events you mearly have to derive from this class and
provide a method with the correct name.  See the comtypes package
documentation for more details.



|

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

Inheritance diagram for class **ActiveXCtrl**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/lib.activex.ActiveXCtrl_inheritance.png" alt="Inheritance diagram of ActiveXCtrl" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="Window.html" title="Window  is the base class for all windows and represents any visible object on screen." alt="" coords="396,5,476,35"/> <area shape="rect" id="node2" href="EvtHandler.html" title="A class that can handle events from the windowing system." alt="" coords="247,5,345,35"/> <area shape="rect" id="node4" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="125,5,197,35"/> <area shape="rect" id="node8" href="lib.activex.ActiveXCtrl.html" title="A wx.Window for hosting ActiveX controls.  The COM interface of" alt="" coords="732,5,887,35"/> </map> 
   </p>

|


|super_classes| Known Superclasses
==================================

:class:`PyAxBaseWindow`

|


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

================================================================================ ================================================================================
:meth:`~lib.activex.ActiveXCtrl.__init__`                                        All parameters are like those used in normal wx.Windows with
:meth:`~lib.activex.ActiveXCtrl.AddEventSink`                                    Add a new target to search for method names that match the COM
:meth:`~lib.activex.ActiveXCtrl.GetCtrl`                                         Easy access to the COM interface for the ActiveX Control
:meth:`~lib.activex.ActiveXCtrl.MSWTranslateMessage`                             
:meth:`~lib.activex.ActiveXCtrl.OnDestroyWindow`                                 
:meth:`~lib.activex.ActiveXCtrl.OnKillFocus`                                     
:meth:`~lib.activex.ActiveXCtrl.OnSetFocus`                                      
================================================================================ ================================================================================


|


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

================================================================================ ================================================================================
:attr:`~lib.activex.ActiveXCtrl.ctrl`                                            Easy access to the COM interface for the ActiveX Control
================================================================================ ================================================================================


|


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

.. class:: ActiveXCtrl(PyAxBaseWindow)

   A wx.Window for hosting ActiveX controls.  The COM interface of
   the ActiveX control is accessible through the ctrl property of
   this class, and this class is also set as the event sink for COM
   events originating from the ActiveX control.  In other words, to
   catch the COM events you mearly have to derive from this class and
   provide a method with the correct name.  See the comtypes package
   documentation for more details.

   .. method:: __init__(self, parent, axID, wxid=-1, pos=DefaultPosition, size=DefaultSize, style=0, name="activeXCtrl")

      All parameters are like those used in normal wx.Windows with
      the addition of axID which is a string that is either a ProgID
      or a CLSID used to identify the ActiveX control.


   .. method:: AddEventSink(self, sink, interface=None)

      Add a new target to search for method names that match the COM
      Event names.


   .. method:: GetCtrl(self)

      Easy access to the COM interface for the ActiveX Control


   .. method:: MSWTranslateMessage(self, msg)


   .. method:: OnDestroyWindow(self, evt)


   .. method:: OnKillFocus(self, evt)


   .. method:: OnSetFocus(self, evt)


   .. attribute:: ctrl

      See :meth:`~ActiveXCtrl.GetCtrl`