interface ICoreWebView2WindowFeatures

Article
10/21/2024

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

interface ICoreWebView2WindowFeatures
  : public IUnknown

The window features for a WebView popup window.

Summary

Members	Descriptions
get_HasPosition	Specifies left and top values.
get_HasSize	Specifies height and width values.
get_Height	Specifies the height of the window.
get_Left	Specifies the left position of the window.
get_ShouldDisplayMenuBar	Indicates that the menu bar is displayed.
get_ShouldDisplayScrollBars	Indicates that the scroll bars are displayed.
get_ShouldDisplayStatus	Indicates that the status bar is displayed.
get_ShouldDisplayToolbar	Indicates that the browser toolbar is displayed.
get_Top	Specifies the top position of the window.
get_Width	Specifies the width of the window.

The fields match the windowFeatures passed to window.open as specified in Window features on MDN.

There is no requirement for you to respect the values. If your app does not have corresponding UI features (for example, no toolbar) or if all instance of WebView are opened in tabs and do not have distinct size or positions, then your app does not respect the values. You may want to respect values, but perhaps only some apply to the UI of you app. Accordingly, you may respect all, some, or none of the properties as appropriate for your app. For all numeric properties, if the value that is passed to window.open is outside the range of an unsigned 32bit int, the resulting value is the absolute value of the maximum for unsigned 32bit integer. If you are not able to parse the value an integer, it is considered 0. If the value is a floating point value, it is rounded down to an integer.

In runtime versions 98 or later, the values of ShouldDisplayMenuBar, ShouldDisplayStatus, ShouldDisplayToolbar, and ShouldDisplayScrollBars will not directly depend on the equivalent fields in the windowFeatures string. Instead, they will all be false if the window is expected to be a popup, and true if it is not.

Applies to

Product	Introduced
WebView2 Win32	0.9.622.11
WebView2 Win32 Prerelease	0.9.628

Members

get_HasPosition

Specifies left and top values.

public HRESULT get_HasPosition(BOOL * value)

get_HasSize

Specifies height and width values.

public HRESULT get_HasSize(BOOL * value)

get_Height

Specifies the height of the window.

public HRESULT get_Height(UINT32 * value)

Minimum value is 100. If HasSize is set to FALSE, this field is ignored.

get_Left

Specifies the left position of the window.

public HRESULT get_Left(UINT32 * value)

If HasPosition is set to FALSE, this field is ignored.

get_ShouldDisplayMenuBar

Indicates that the menu bar is displayed.

public HRESULT get_ShouldDisplayMenuBar(BOOL * value)

get_ShouldDisplayScrollBars

Indicates that the scroll bars are displayed.

public HRESULT get_ShouldDisplayScrollBars(BOOL * value)

get_ShouldDisplayStatus

Indicates that the status bar is displayed.

public HRESULT get_ShouldDisplayStatus(BOOL * value)

get_ShouldDisplayToolbar

Indicates that the browser toolbar is displayed.

public HRESULT get_ShouldDisplayToolbar(BOOL * value)

get_Top

Specifies the top position of the window.

public HRESULT get_Top(UINT32 * value)