interface IDualEngine20BrowserObserver

重要

DualEngine API 是受限访问功能的一部分， (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请联系 Microsoft支持。

interface IDualEngine20BrowserObserver
  : public IUnknown

从浏览器接收事件。

摘要

Members	说明
ContinueNavigationInEdge	当浏览器想要停止托管内容并在托管过程中继续导航到 URL 时引发。
ContinueNavigationInEdge2	当浏览器想要停止托管内容并在托管过程中继续导航到 URL 时引发;此版本提供有关导航的额外信息。
NavigateToOffsetInEdge	当浏览器请求导航到旅行日志条目偏移量时引发。
OnAllButCurrentEntryDeleted	当浏览器删除其旅行日志中的所有条目（当前条目除外）时引发。
OnAsyncHungCheckReply	在浏览器处理异步挂起检查消息时引发，请参阅 IDualEngine20BrowserSession：：SetHangDetectionMessages () 。
OnAttentionState	请求用户注意时引发。
OnBeforeUnloadAndStopComplete	在 beforeUnload 事件完成处理时引发。
OnCloseCompleted	在浏览器关闭时引发。
OnCloseRequested	在浏览器请求关闭时引发。
OnDialogShown	当浏览器显示或隐藏模式对话框时引发。
OnDocumentComplete	在完全加载并初始化文档时引发。
OnDocumentModeSet	文档模式更改时引发。
OnEnterpriseIDSet	导航完成时引发;提供有关企业 ID 的信息。
OnFindOnPageResult	在页面结果更改时引发。
OnFinishedSetFocus	当 IDualEngine20Browser：:D ualEngineSetFocus () 请求完成处理时引发。
OnGeolocationFeatureInUse	访问地理位置数据时引发。
OnGeolocationPermissionRequested	需要用户权限才能启用地理位置时引发。
OnHasBeforeUnloadChanged	在注册或删除处理程序时 OnBeforeUnload 引发。
OnIndicatorItemsSet	导航完成时引发;提供有关浏览器页面当前状态的状态信息。
OnInputAttempted	收到用户输入时引发。
OnLoadingActivityChanged	页面的加载状态更改时引发。
OnMixedContentBlocked	在阻止混合内容时引发。
OnNavigationComplete	导航完成时引发。
OnNavigationFailed	导航失败时引发。
OnNavigationToDownload	在下载中结束导航时引发。
OnNewWindow	创建新窗口时引发。
OnPopupBlocked	弹出窗口被阻止时引发。
OnPrepareToExitRegionFailed	当浏览器未能处理上一个 IDualEngine20Browser：:D ualEnginePrepareToExitRegion () 调用时引发。
OnReadyToExitRegion	在浏览器成功处理以前的 IDualEngine20Browser：:D ualEnginePrepareToExitRegion () 调用时引发。
OnTabCrashed	选项卡崩溃时引发。
OnTabHangReported	在浏览器挂起时引发。
OnUnexpectedRundown	浏览器意外关闭时引发。
OnUnhandledKeyboardAccelerator	在处理键盘快捷键时引发，并确定浏览器不处理或不应基于 rgHostPriorityAccels处理该快捷键。
OnUnhandledKeyboardAcceleratorAsync	在处理键盘快捷键时引发，并确定浏览器不处理或不应基于 rgHostPriorityAccels处理该快捷键。
OnVisibleComplete	当页面的内容可见时引发。
OnZoomChanged	缩放发生更改时引发。
OpenURLInEdge	当浏览器请求主机导航到新窗口中的 URL 时引发。
OpenURLInEdge2	当浏览器请求主机导航到新窗口中的 URL 时引发;此版本提供有关导航的额外信息。
RequestHostAddFavorite	请求将页面添加到收藏夹时引发。
RequestHostCreateUrlTip	请求显示包含 URL 的工具提示时引发。
RequestHostFocus	请求焦点移动到主机窗口时引发。
RequestHostFullscreen	当页面请求主机全屏显示内容时引发。
RequestHostHideUrlTip	请求隐藏包含 URL 的工具提示时引发。
RequestHostPositionChanged	当浏览器请求主机更改其大小或位置时引发。
RequestHostShowTheater	当浏览器请求主机进入或退出影院模式时引发。
RequestHostWindowFocus	当请求主机获取或放弃焦点时引发。
RequestHostWindowFocusSync	当请求主机获取或放弃焦点时引发。
UpdateHostFavicon	当 favicon 已更改时引发。
UpdateHostTitle	更新页面标题时引发。
UpdateSecureLockIcon	当页面的安全信息发生更改时引发。

适用对象

产品	引入
Windows 10 版本 20H1	KB5032278
Windows 11 版本 22H2	KB5032288

Members

ContinueNavigationInEdge

当浏览器想要停止托管内容并在托管过程中继续导航到 URL 时引发。

public HRESULT ContinueNavigationInEdge (LPCWSTR pszUrl， ULONG ulCookieSyncVersion)

参数

• pszUrl 应导航到的 URL。

• ulCookieSyncVersion 一个数字，可用于将导航与特定 Cookie 状态相关联。

ContinueNavigationInEdge2

当浏览器想要停止托管内容并在托管过程中继续导航到 URL 时引发;此版本提供有关导航的额外信息。

public HRESULT ContinueNavigationInEdge2 (LPCWSTR pszUrl， ULONG ulCookieSyncVersion， LPCWSTR pszReferrer， LPCWSTR pszHeaders， VARIANT * postData)

参数

• pszUrl 应导航到的 URL。

• ulCookieSyncVersion 一个数字，可用于将导航与特定 Cookie 状态相关联。

• pszReferrer HTTP 引用器请求标头。

• pszHeaders 其他 HTTP 标头。

• postData HTTP POST 数据，例如表单数据。

NavigateToOffsetInEdge

当浏览器请求导航到旅行日志条目偏移量时引发。

public HRESULT NavigateToOffsetInEdge (int iOffset)

参数

• iOffset 要导航到的偏移量。

OnAllButCurrentEntryDeleted

当浏览器删除其旅行日志中的所有条目（当前条目除外）时引发。

public HRESULT OnAllButCurrentEntryDeleted (VisibleListUpdateEntry * pVisibleListEntries， int cVisibleListEntries)

参数

• pVisibleListEntries 包含自上次更新以来的新旅行日志条目的列表。 在这种情况下，它将仅具有当前活动条目。

• cVisibleListEntries 中的项数 pVisibleListEntries

OnAsyncHungCheckReply

在浏览器处理异步挂起检查消息时引发，请参阅 IDualEngine20BrowserSession：：SetHangDetectionMessages () 。

public HRESULT OnAsyncHungCheckReply (ULONG correlationId)

参数

• correlationId 用于将答复与发送的消息关联的 ID。

OnAttentionState

请求用户注意时引发。

public HRESULT OnAttentionState (ATTENTIONSTATE attentionState)

参数

• attentionState 请求用户注意的原因。

OnBeforeUnloadAndStopComplete

在 beforeUnload 事件完成处理时引发。

public HRESULT OnBeforeUnloadAndStopComplete (BOOL agreeToClose)

参数

• agreeToClose 指示用户是否同意离开页面。

OnCloseCompleted

在浏览器关闭时引发。

public HRESULT OnCloseCompleted ()

OnCloseRequested

在浏览器请求关闭时引发。

public HRESULT OnCloseRequested ()

OnDialogShown

当浏览器显示或隐藏模式对话框时引发。

public HRESULT OnDialogShown (BOOL fShown)

参数

• fShown 指示对话框是显示还是隐藏。

OnDocumentComplete

在完全加载并初始化文档时引发。

public HRESULT OnDocumentComplete (ULONG ulCurrentEntryId， VisibleListUpdateEntry * pVisibleListEntries， int cVisibleListEntries)

参数

• ulCurrentEntryId 引发此事件的页的旅行日志条目 ID。

• pVisibleListEntries 包含自上次更新以来的新旅行日志条目的列表。

• cVisibleListEntries 中的项数 pVisibleListEntries

OnDocumentModeSet

文档模式更改时引发。

public HRESULT OnDocumentModeSet (ULONG documentMode)

参数

• documentMode 新的文档模式版本。

OnEnterpriseIDSet

导航完成时引发;提供有关企业 ID 的信息。

public HRESULT OnEnterpriseIDSet (BOOL fEnterpriseID)

参数

• fEnterpriseID 指示浏览器是否设置了企业 ID。

OnFindOnPageResult

在页面结果更改时引发。

public HRESULT OnFindOnPageResult (int iRequestID， int cMatches， int iActiveMatch)

参数

• iRequestID 用于将结果与 IDualEngine20Browser：:D ualEngineFindOnPage 关联 () 请求的 ID。

• cMatches 匹配的计数。

• iActiveMatch 所选匹配项的索引。

OnFinishedSetFocus

当 IDualEngine20Browser：:D ualEngineSetFocus () 请求完成处理时引发。

public HRESULT OnFinishedSetFocus ()

OnGeolocationFeatureInUse

访问地理位置数据时引发。

public HRESULT OnGeolocationFeatureInUse (LPCWSTR pszContextUrl， SITE_PERMISSION_FEATURE_MODE featureMode)

参数

• pszContextUrl 访问地理位置数据的页面的 URL。

• featureMode 指示访问是被阻止还是允许。

OnGeolocationPermissionRequested

需要用户权限才能启用地理位置时引发。

public HRESULT OnGeolocationPermissionRequested (LPCWSTR pszContextUrl)

参数

• pszContextUrl 请求地理位置权限的页面的 URL。

OnHasBeforeUnloadChanged

在注册或删除处理程序时 OnBeforeUnload 引发。

public HRESULT OnHasBeforeUnloadChanged (BOOL fBeforeUnload)

参数

• fBeforeUnload true 指示已注册处理程序 OnBeforeUnload ; false 指示它已被删除。

OnIndicatorItemsSet

导航完成时引发;提供有关浏览器页面当前状态的状态信息。

public HRESULT OnIndicatorItemsSet (BOOL fProtectedMode、BOOL fEnhancedProtectedMode、DWORD dwUrlZone、BOOL fEnterpriseMode)

参数

• fProtectedMode 指示浏览器是否处于保护模式。

• fEnhancedProtectedMode 指示浏览器是否处于增强保护模式。

• dwUrlZone 当前 URL 的区域。

• fEnterpriseMode 指示浏览器是否处于企业模式。

OnInputAttempted

收到用户输入时引发。

public HRESULT OnInputAttempted ()

OnLoadingActivityChanged

页面的加载状态更改时引发。

public HRESULT OnLoadingActivityChanged (BOOL fLoading)

参数

• fLoading 指示页面是否正在加载。

OnMixedContentBlocked

在阻止混合内容时引发。

public HRESULT OnMixedContentBlocked ()

OnNavigationComplete

导航完成时引发。

public HRESULT OnNavigationComplete (REFGUID guidTabId， ULONG ulCurrentEntryId， VisibleListUpdateEntry * pVisibleListEntries， int cVisibleListEntries， DWORD dwNavFlags， SECURELOCKICON secureLockIcon， DWORD dwSecurityFlags， CryptDataBlob * pDualEngineCertificates， int cCertificateChainBlobs)

参数

• guidTabId 选项卡的恢复 GUID。

• ulCurrentEntryId 在可见条目列表中表示此导航的 ID。

• pVisibleListEntries 包含自上次更新以来的新旅行日志条目的列表。

• cVisibleListEntries 中的 pVisibleListEntries项数。

• dwNavFlags 指示发生的导航类型的标志。

• secureLockIcon 页面的安全状态。

• dwSecurityFlags 指示页面的任何证书错误的标志。

• pDualEngineCertificates 包含当前条目页面的证书链的列表。

• cCertificateChainBlobs 中的 pDualEngineCertificates项数。

OnNavigationFailed

导航失败时引发。

public HRESULT OnNavigationFailed (NAVIGATIONFAILEDREASON failureReason)

参数

• failureReason 导航失败的原因。

OnNavigationToDownload

在下载中结束导航时引发。

public HRESULT OnNavigationToDownload ()

OnNewWindow

创建新窗口时引发。

public HRESULT OnNewWindow (IDualEngine20Browser * pNewBrowser， HWND hwnd， const DualEngineNewWindowOptions * options， IDualEngine20BrowserObserver ** ppObserver)

参数

• pNewBrowser 新窗口的浏览器对象。

• hwnd 新窗口的句柄。

• options 创建新窗口时所使用的选项。

• ppObserver 新窗口的观察者对象。

OnPopupBlocked

弹出窗口被阻止时引发。

public HRESULT OnPopupBlocked (LPCWSTR pszContextUrl， LPCWSTR pszPopupUrl)

参数

• pszContextUrl 发出命令以打开弹出窗口的页面的 URL。

• pszPopupUrl 弹出页的 URL。

OnPrepareToExitRegionFailed

当浏览器未能处理上一个 IDualEngine20Browser：:D ualEnginePrepareToExitRegion () 调用时引发。

public HRESULT OnPrepareToExitRegionFailed ()

OnReadyToExitRegion

在浏览器成功处理以前的 IDualEngine20Browser：:D ualEnginePrepareToExitRegion () 调用时引发。

public HRESULT OnReadyToExitRegion (REFGUID guidClonedTabId， ULONG ulCurrentEntryId， VisibleListUpdateEntry * pVisibleListEntriesComplete， int cVisibleListEntriesComplete)

参数

• guidClonedTabId 支持退出区域的选项卡恢复数据文件的 GUID。

• ulCurrentEntryId 引发此事件的页的旅行日志条目 ID。

• pVisibleListEntriesComplete 包含自上次更新以来的新旅行日志条目的列表。

• cVisibleListEntriesComplete 中的项数 pVisibleListEntriesComplete

OnTabCrashed

选项卡崩溃时引发。

public HRESULT OnTabCrashed (BOOL fUnrecoverable)

参数

• fUnrecoverable 指示选项卡是否可恢复。

OnTabHangReported

在浏览器挂起时引发。

public HRESULT OnTabHangReported ()

OnUnexpectedRundown

浏览器意外关闭时引发。

public HRESULT OnUnexpectedRundown ()

OnUnhandledKeyboardAccelerator

在处理键盘快捷键时引发，并确定浏览器不处理或不应基于 rgHostPriorityAccels处理该快捷键。

public HRESULT OnUnhandledKeyboardAccelerator (LPMSG lpMsg)

参数

• lpMsg 未处理的键盘快捷键的 win32 消息。

OnUnhandledKeyboardAcceleratorAsync

在处理键盘快捷键时引发，并确定浏览器不处理或不应基于 rgHostPriorityAccels处理该快捷键。

public HRESULT OnUnhandledKeyboardAcceleratorAsync (LPMSG pMsg、BOOL isShiftDown、BOOL isCtrlDown、BOOL isAltDown)

在此版本的 方法中，事件以异步方式引发，并且键盘状态在处理后可能已更改，因此提供了修饰键的状态。

参数

• pMsg 未处理的键盘快捷键的 win32 消息。

• isShiftDown 指示是否已按下 Shift 键。

• isCtrlDown 指示是否按了 Ctrl 键。

• isAltDown 指示是否已按下 Alt 键。

OnVisibleComplete

当页面的内容可见时引发。

public HRESULT OnVisibleComplete ()

OnZoomChanged

缩放发生更改时引发。

public HRESULT OnZoomChanged (ULONG ulZoomPercent)

参数

• ulZoomPercent 新的缩放百分比。

OpenURLInEdge

当浏览器请求主机导航到新窗口中的 URL 时引发。

public HRESULT OpenURLInEdge (LPCWSTR pszUrl， const DualEngineNewWindowOptions * options， ULONG ulCookieSyncVersion)

参数

• pszUrl 要导航到的 URL。

• options 要应用于新窗口的选项。

• ulCookieSyncVersion 一个数字，可用于将导航与特定 Cookie 状态相关联。

OpenURLInEdge2

当浏览器请求主机导航到新窗口中的 URL 时引发;此版本提供有关导航的额外信息。

public HRESULT OpenURLInEdge2 (LPCWSTR pszUrl， const DualEngineNewWindowOptions * options， ULONG ulCookieSyncVersion， LPCWSTR pszReferrer， LPCWSTR pszHeaders， VARIANT * postData)

参数

• pszUrl 要导航到的 URL。

• options 要应用于导航的选项。

• ulCookieSyncVersion 一个数字，可用于将导航与特定 Cookie 状态相关联。

• pszReferrer HTTP 引用器请求标头。

• pszHeaders 其他 HTTP 标头。

• postData HTTP POST 数据，例如表单数据。

RequestHostAddFavorite

请求将页面添加到收藏夹时引发。

public HRESULT RequestHostAddFavorite (LPCWSTR pszTitle， LPCWSTR pszUrl)

参数

• pszTitle 页面的标题。

• pszUrl 页面的 URL。

RequestHostCreateUrlTip

请求显示包含 URL 的工具提示时引发。

public HRESULT RequestHostCreateUrlTip (LPCWSTR pszUrl)

参数

• pszUrl 要显示在工具提示中的 URL。

RequestHostFocus

请求焦点移动到主机窗口时引发。

public HRESULT RequestHostFocus (DUALENGINE_FOCUSDIRECTION focusDirection，const MSG * msg)

参数

• focusDirection 焦点移动的方向。

• msg 指向导致焦点更改的消息的指针。

RequestHostFullscreen

当页面请求主机全屏显示内容时引发。

public HRESULT RequestHostFullscreen (FULLSCREENACTION fullScreenAction)

参数

• fullScreenAction 正在请求的全屏操作。

RequestHostHideUrlTip

请求隐藏包含 URL 的工具提示时引发。

public HRESULT RequestHostHideUrlTip ()

RequestHostPositionChanged

当浏览器请求主机更改其大小或位置时引发。

public HRESULT RequestHostPositionChanged (LONG nX、LONG nY、LONG nWidth、LONG nHeight、ULONGLONG hSyncEvent)

参数

• nX 请求的窗口 X 位置。

• nY 请求的窗口 Y 位置。

• nWidth 请求的窗口宽度。

• nHeight 请求的窗口高度。

• hSyncEvent 事件对象的句柄，应在更改完成时发出信号。

RequestHostShowTheater

当浏览器请求主机进入或退出影院模式时引发。

public HRESULT RequestHostShowTheater (BOOL fShow)

参数

• fShow 如果 true为 ，则请求主机进入剧院模式;如果 false为 ，则请求主机退出剧院模式。

RequestHostWindowFocus

当请求主机获取或放弃焦点时引发。

public HRESULT RequestHostWindowFocus (BOOL fFocus)

参数

• fFocus 指示应使用焦点执行哪些操作。 如果 true为 ，则应获取焦点;否则应放弃焦点。

RequestHostWindowFocusSync

当请求主机获取或放弃焦点时引发。

public HRESULT RequestHostWindowFocusSync (BOOL fFocus、ULONGLONG hSyncEvent)

在此版本的 方法中，浏览器将等待，直到提供的事件收到信号。

参数

• fFocus 指示应使用焦点执行哪些操作。 如果 true为 ，则应获取焦点;否则应放弃焦点。

• hSyncEvent 事件对象的句柄，应在更改完成时发出信号。

UpdateHostFavicon

当 favicon 已更改时引发。

public HRESULT UpdateHostFavicon (ULONG ulCurrentEntryId， LPCWSTR spszCurrentUrl， LPCWSTR * pIconUrls， int cIconUrls)

参数

• ulCurrentEntryId 引发此事件的页的旅行日志条目 ID。

• spszCurrentUrl 页面的 URL。

• pIconUrls favicon URL 的列表。

• cIconUrls 中的 pIconUrls项数。

UpdateHostTitle

更新页面标题时引发。

public HRESULT UpdateHostTitle (ULONG ulCurrentEntryId， LPCWSTR pszTitle)

参数

• ulCurrentEntryId 引发此事件的可见条目列表中的页面的 ID。

• pszTitle 新标题。

UpdateSecureLockIcon

当页面的安全信息发生更改时引发。

public HRESULT UpdateSecureLockIcon (ULONG ulCurrentEntryId，SECURELOCKICON secureLockIcon)

参数

• ulCurrentEntryId 此更改的旅行日志条目。

• secureLockIcon 安全信息的状态。