WindowHandle

class WindowHandle

Bases: TypedReferenceCount

This object represents a window on the desktop, not necessarily a Acron window. This structure can be assigned to a WindowProperties to indicate a parent window.

It also has callbacks so the Acron window can communicate with its parent window, which is particularly important when running embedded in a browser.

To create a WindowHandle, you would usually call one of the NativeWindowHandle::make_*() methods, depending on the kind of native window handle object you already have.

Inheritance diagram

digraph inheritance211f298a54 { bgcolor=transparent; rankdir=BT; size="8.0, 12.0"; "DTOOL_SUPER_BASE" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style=""]; "ReferenceCount" [URL="acron.core.ReferenceCount.html#acron.core.ReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "ReferenceCount" [arrowsize=0.75,style=""]; "TypedObject" [URL="acron.core.TypedObject.html#acron.core.TypedObject",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "DTOOL_SUPER_BASE" -> "TypedObject" [arrowsize=0.75,style=""]; "TypedReferenceCount" [URL="acron.core.TypedReferenceCount.html#acron.core.TypedReferenceCount",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedObject" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; "ReferenceCount" -> "TypedReferenceCount" [arrowsize=0.75,style=""]; "WindowHandle" [URL="acron.core.WindowHandle.html#acron.core.WindowHandle",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="",target="_top",tooltip="/**"]; "TypedReferenceCount" -> "WindowHandle" [arrowsize=0.75,style=""]; }

class WindowHandle.OSHandle

Bases:

Bases: TypedReferenceCount

This internal pointer within WindowHandle stores the actual OS-specific window handle type, whatever type that is. It is subclassed for each OS.

__init__()

The base class of OSHandle doesn’t have a usable constructor. Always construct an instance of some specialized type, that stores the appropriate kind of window handle for each OS.

static get_class_type()

get_int_handle()

Returns the OS-specific handle converted to an integer, if this is possible for the particular representation. Returns 0 if it is not.

output()

WindowHandle.__init__()

static WindowHandle.get_class_type()

WindowHandle.get_int_handle()

Returns the OS-specific handle converted to an integer, if this is possible for the particular representation. Returns 0 if it is not.

WindowHandle.get_os_handle()

Returns the OS-specific handle stored internally to the WindowHandle wrapper.

WindowHandle.output()

WindowHandle.send_windows_message()

Call this method on a parent WindowHandle to deliver a Windows message to the current child window, if any. This is used in the web plugin system to deliver button events detected directly by the browser system into Acron, which is particularly necessary on Vista.

WindowHandle.set_os_handle()

Changes the OS-specific handle stored internally to the WindowHandle wrapper.