.. include:: headings.inc



.. _NonOwnedWindow:

==========================================================================================================================================
|phoenix_title|  **NonOwnedWindow**
==========================================================================================================================================

Common base class for all non-child windows.          

This is the common base class of :ref:`TopLevelWindow`  and :ref:`PopupWindow`  and is not used directly. 

Currently the only additional functionality it provides, compared to base :ref:`Window`  class, is the ability to set the window shape. 

         



.. versionadded:: 2.9.3 
     







|

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

Inheritance diagram for class **NonOwnedWindow**

.. raw:: html

   <p class="graphviz">
   <img src="_static/images/inheritance/NonOwnedWindow_inheritance.png" alt="Inheritance diagram of NonOwnedWindow" usemap="#dummy" class="inheritance"/>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="16,5,88,35"/> <area shape="rect" id="node3" href="EvtHandler.html" title="A class that can handle events from the windowing system." alt="" coords="148,31,247,62"/> <area shape="rect" id="node2" href="Trackable.html" title="Add-on base class for a trackable object." alt="" coords="5,58,99,89"/> <area shape="rect" id="node7" href="Window.html" title="Window  is the base class for all windows and represents any visible object on screen." alt="" coords="297,31,377,62"/> <area shape="rect" id="node6" href="NonOwnedWindow.html" title="Common base class for all non-child windows." alt="" coords="427,31,587,62"/> </map> 
   </p>

|


|sub_classes| Known Subclasses
==============================

:ref:`PopupWindow`, :ref:`TopLevelWindow`

|


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

================================================================================ ================================================================================
:meth:`~NonOwnedWindow.SetShape`                                                 If the platform supports it, sets the shape of the window to that depicted by `region`.
================================================================================ ================================================================================


|


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

.. class:: NonOwnedWindow(Window)

   Common base class for all non-child windows.



   .. method:: SetShape(self, *args, **kw)



      |overload| **Overloaded Implementations**:

      **~~~**

      
      **SetShape** `(self, region)`
      
      If the platform supports it, sets the shape of the window to that depicted by `region`.                  
      
      The system will not display or respond to any mouse event for the pixels that lie outside of the region. To reset the window to the normal rectangular shape simply call :meth:`SetShape`   again with an empty :ref:`Region`. Returns ``True`` if the operation is successful. 
      
      This method is available in this class only since wxWidgets 2.9.3, previous versions only provided it in :ref:`TopLevelWindow`.                  
      
      
      :param `region`: 
      :type `region`: Region
      
      
      
      
      :rtype: `bool`
      
      
      
      
      
      
      
      **~~~**

      
      **SetShape** `(self, path)`
      
      Set the window shape to the given path.                  
      
      Set the window shape to the interior of the given path and also draw the window border along the specified path. 
      
      For example, to make a clock-like circular window you could use ::
      
                      size = self.GetSize()
      
                      path = wx.GraphicsRenderer.GetDefaultRenderer().CreatePath()
                      path.AddCircle(size.x/2, size.y/2, 30)
                      
                      self.SetShape(path)
      
      
      
      As the overload above, this method is not guaranteed to work on all platforms but currently does work in wxMSW, OSX/Cocoa and wxGTK (with the appropriate but almost always present X11 extensions) ports. 
      
                      
      
      
      :param `path`: 
      :type `path`: GraphicsPath
      
      
      
      
      :rtype: `bool`
      
      
      
      
      
      
      
      .. versionadded:: 2.9.3 
           
      
      
      
      
      
      
      
      **~~~**