interface ICoreWebView2NewWindowRequestedEventArgs
interface ICoreWebView2NewWindowRequestedEventArgs
: public IUnknown
Event args for the NewWindowRequested event.
Summary
Members | Descriptions |
---|---|
get_Handled | Gets whether the NewWindowRequestedEvent is handled by host. |
get_IsUserInitiated | IsUserInitiated is true when the new window request was initiated through a user gesture such as clicking an anchor tag with target. |
get_NewWindow | Gets the new window. |
get_Uri | The target uri of the NewWindowRequest. |
get_WindowFeatures | Window features specified by the window.open call. |
GetDeferral | Obtain an ICoreWebView2Deferral object and put the event into a deferred state. |
put_Handled | Sets whether the NewWindowRequestedEvent is handled by host. |
put_NewWindow | Sets a WebView as a result of the NewWindowRequest. |
The event is fired when content inside webview requested to a open a new window (through window.open() and so on.)
Members
get_Handled
Gets whether the NewWindowRequestedEvent is handled by host.
public HRESULT get_Handled(BOOL * handled)
get_IsUserInitiated
IsUserInitiated is true when the new window request was initiated through a user gesture such as clicking an anchor tag with target.
public HRESULT get_IsUserInitiated(BOOL * isUserInitiated)
The Edge popup blocker is disabled for WebView so the app can use this flag to block non-user initiated popups.
get_NewWindow
Gets the new window.
public HRESULT get_NewWindow(ICoreWebView2 ** newWindow)
get_Uri
The target uri of the NewWindowRequest.
public HRESULT get_Uri(LPWSTR * uri)
get_WindowFeatures
Window features specified by the window.open call.
public HRESULT get_WindowFeatures(ICoreWebView2WindowFeatures ** windowFeatures)
These features can be considered for positioning and sizing of new webview windows.
GetDeferral
Obtain an ICoreWebView2Deferral object and put the event into a deferred state.
public HRESULT GetDeferral(ICoreWebView2Deferral ** deferral)
You can use the ICoreWebView2Deferral object to complete the window open request at a later time. While this event is deferred the opener window will be returned a WindowProxy to an unnavigated window, which will navigate when the deferral is complete.
put_Handled
Sets whether the NewWindowRequestedEvent is handled by host.
public HRESULT put_Handled(BOOL handled)
If this is false and no NewWindow is set, the WebView will open a popup window and it will be returned as opened WindowProxy. If set to true and no NewWindow is set for a window.open call, the opened WindowProxy will be for an dummy window object and no window will load. Default is false.
put_NewWindow
Sets a WebView as a result of the NewWindowRequest.
public HRESULT put_NewWindow(ICoreWebView2 * newWindow)
The target WebView should not be navigated. If the NewWindow is set, its top level window will return as the opened WindowProxy.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour