interface ICoreWebView2NavigationStartingEventArgs

interface ICoreWebView2NavigationStartingEventArgs
  : public IUnknown

Event args for the NavigationStarting event.

Summary

Members Descriptions
get_Cancel The host may set this flag to cancel the navigation.
get_IsRedirected True when the navigation is redirected.
get_IsUserInitiated True when the navigation was initiated through a user gesture as opposed to programmatic navigation.
get_NavigationId The ID of the navigation.
get_RequestHeaders The HTTP request headers for the navigation.
get_Uri The uri of the requested navigation.
put_Cancel Set the Cancel property.

Members

get_Cancel

The host may set this flag to cancel the navigation.

public HRESULT get_Cancel(BOOL * cancel)

If set, it will be as if the navigation never happened and the current page's content will be intact. For performance reasons, GET HTTP requests may happen, while the host is responding. This means cookies can be set and used part of a request for the navigation. Cancellation for navigation to about:blank or frame navigation to srcdoc is not supported. Such attempts will be ignored.

get_IsRedirected

True when the navigation is redirected.

public HRESULT get_IsRedirected(BOOL * isRedirected)

get_IsUserInitiated

True when the navigation was initiated through a user gesture as opposed to programmatic navigation.

public HRESULT get_IsUserInitiated(BOOL * isUserInitiated)

get_NavigationId

The ID of the navigation.

public HRESULT get_NavigationId(UINT64 * navigationId)

get_RequestHeaders

The HTTP request headers for the navigation.

public HRESULT get_RequestHeaders(ICoreWebView2HttpRequestHeaders ** requestHeaders)

Note, you cannot modify the HTTP request headers in a NavigationStarting event.

get_Uri

The uri of the requested navigation.

public HRESULT get_Uri(LPWSTR * uri)

put_Cancel

Set the Cancel property.

public HRESULT put_Cancel(BOOL cancel)