CanvasRenderingContext2D.drawWidgetAsOnScreen()

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The non-standard and internal only CanvasRenderingContext2D.drawWidgetAsOnScreen() method of the Canvas 2D API renders the root widget of a window into the canvas. Unlike drawWindow(), this API uses the operating system to snapshot the widget on-screen, rather than reading from Gecko's own compositor.

This API cannot be used by Web content. It is only supported on Windows, only on widgets that use OMTC, and only from within the chrome process.

Syntax

void ctx.drawWidgetAsOnScreen(window);

Parameters

window
The Window to render.

Specifications

Not part of any current specification or draft. This is a non-standard and internal only API.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
drawWidgetAsOnScreen
Non-standard
Chrome No support NoEdge No support NoFirefox Full support 41IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android Full support 41Opera Android No support NoSafari iOS No support NoSamsung Internet Android No support No

Legend

Full support
Full support
No support
No support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.

See also