通过

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 数据，例如表单数据。

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

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)

参数

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 安全信息的状态。

  • Last updated on