WindowInfo.md

API categories | API index

WindowInfo (class)

This class is passed to functions eg. cefpython.CreateBrowserSync(), LifespanHandler.OnBeforePopup().

To instantiate this class call: cefpython.WindowInfo().

Table of contents:

• Methods
  • SetAsChild
  • SetAsPopup
  • SetAsOffscreen
  • SetTransparentPainting

Methods

SetAsChild

Parameter	Type
parentWindowHandle	int
windowRect (optional)	list
Return	void

Create the browser as a child window/view.

windowRect example value: [left, top, right, bottom].

SetAsPopup

Parameter	Type
parentWindowHandle	int
windowName	string
Return	void

Available only on Windows.

SetAsOffscreen

Parameter	Type
parentWindowHandle	int
Return	void

Upstream CEF description:

Create the browser using windowless (off-screen) rendering. No window will be created for the browser and all rendering will occur via the CefRenderHandler interface. The |parent| value will be used to identify monitor info and to act as the parent window for dialogs, context menus, etc. If |parent| is not provided then the main screen monitor will be used and some functionality that requires a parent window may not function correctly. If |transparent| is true a transparent background color will be used (RGBA=0x00000000). If |transparent| is false the background will be white and opaque. In order to create windowless browsers the CefSettings.windowless_rendering_enabled value must be set to true.

Call this method to disable windowed rendering and to use RenderHandler. See the Panda3D and Kivy examples.

In order to create windowless browsers the ApplicationSettings.windowless_rendering_enabled value must be set to true.

You can pass 0 as parentWindowHandle, but then some things like context menus and plugins may not display correctly.

SetTransparentPainting

Parameter	Type
transparentPainting	bool
Return	void

This method is intended for use with off-screen rendering only.