interface ICoreWebView2ExperimentalFrameInfo

Artikel
08/30/2023

Note

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

Note

This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.

interface ICoreWebView2ExperimentalFrameInfo
  : public IUnknown

This is the ICoreWebView2ExperimentalFrameInfo that provides ParentFrameInfo, FrameId and FrameKind properties.

Summary

Members	Descriptions
get_FrameId	The unique identifier of the frame associated with the current `FrameInfo`.
get_FrameKind	The frame kind of the frame.
get_ParentFrameInfo	This frame's parent frame's `FrameInfo`.

Applies to

Product	Introduced
WebView2 Win32	N/A
WebView2 Win32 Prerelease	1.0.1988

Members

get_FrameId

The unique identifier of the frame associated with the current FrameInfo.

public HRESULT get_FrameId(UINT32 * id)

It's the same kind of ID as with the FrameId in CoreWebView2 and via CoreWebView2Frame. FrameId will only be populated when obtained calling CoreWebView2ProcessInfo.AssociatedFrameInfos. CoreWebView2FrameInfo objects obtained via CoreWebView2.ProcessFailed will always have an invalid frame Id 0. Note that this FrameId could be out of date as it's a snapshot.

get_FrameKind

The frame kind of the frame.

public HRESULT get_FrameKind(COREWEBVIEW2_FRAME_KIND * kind)

FrameKind will only be populated when obtained calling CoreWebView2ProcessInfo.AssociatedFrameInfos. CoreWebView2FrameInfo objects obtained via CoreWebView2.ProcessFailed will always have the default value COREWEBVIEW2_FRAME_KIND_OTHER. Note that this FrameKind could be out of date as it's a snapshot.

get_ParentFrameInfo

This frame's parent frame's FrameInfo.

public HRESULT get_ParentFrameInfo(ICoreWebView2FrameInfo ** frameInfo)

ParentFrameInfo will only be populated when obtained via calling CoreWebView2ProcessInfo.AssociatedFrameInfos. CoreWebView2FrameInfo objects obtained via CoreWebView2.ProcessFailed will always have a null``ParentFrameInfo. This property is also null for the top most document in the WebView2 which has no parent frame. Note that this ParentFrameInfo could be out of date as it's a snapshot.

Freigeben über