GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Table of Contents
  • wx.NonOwnedWindow
  • Show Source
  • index
  • modules
  • next
  • previous
  • Home
  • Gallery
  • wx

This view

  • Original page
  • New address

GeezerVison is showing docs.wxpython.org — wx.NonOwnedWindow — wxPython 4.3.2 Docs

phoenix_title wx.NonOwnedWindow¶

Common base class for all non-child windows.

This is the common base class of wx.TopLevelWindow and wx.PopupWindow and is not used directly.

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

Added in version 2.9.3.


class_hierarchy Class Hierarchy¶

Inheritance diagram for class NonOwnedWindow:

Inheritance diagram of NonOwnedWindow


sub_classes Known Subclasses¶

wx.PopupWindow, wx.TopLevelWindow


method_summary Methods Summary¶

SetShape

If the platform supports it, sets the shape of the window to that depicted by region.


api Class API¶

class wx.NonOwnedWindow(Window)¶

Common base class for all non-child windows.


Methods¶

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 SetShape again with an empty wx.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 wx.TopLevelWindow.

Note that windows with non default shape have a fixed size and can’t be resized using SetSize .

Parameters:

region (wx.Region)

Return type:

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)

Note that windows with non default shape have a fixed size and can’t be resized using SetSize .

As the overload above, this method is not guaranteed to work on all platforms but currently does work in wxMSW, OSX/Cocoa, wxGTK (with the appropriate but almost always present X11 extensions) and Qt ports.

Parameters:

path (wx.GraphicsPath)

Return type:

bool

Added in version 2.9.3.



© Copyright 2012-2026, The wxPython Team. Created using Sphinx 9.1.0 and the python-docs-theme.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.