通过

interface IDualEngine20Browser

重要

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

interface IDualEngine20Browser
  : public IUnknown

表示 Internet Explorer 选项卡。

摘要

Members 说明
DualEngineBrowserCommitted 通知浏览器它已提交，并且不再具有推理性。
DualEngineClose 关闭浏览器实例。
DualEngineDeleteTabRecoveryData 删除选项卡恢复数据。
DualEngineDoOnBeforeUnloadAndStop 停止正在进行的任何导航并运行 onBeforeUnload 处理程序。
DualEngineDPIChanged 通知 DPI 已更改，应重新计算页面布局。
DualEngineEnableCaretMode 启用或禁用插入点浏览模式。
DualEngineExecNavigationCommand 执行导航命令。
DualEngineFindOnPage 在页面上查找文本的实例。
DualEngineForceClose 强制关闭浏览器实例。
DualEngineGeolocationPermissionResponse 提供对地理位置权限请求的响应。
DualEngineGoToEntry 导航到特定的旅行日志条目。
DualEngineInitialize 使用 URL 初始化浏览器对象。
DualEngineInitialize2 使用 URL 初始化浏览器对象;此版本允许传入有关初始导航的其他信息。
DualEngineInitializeWithRecoveryData 使用选项卡恢复数据初始化浏览器对象。
DualEngineLostFocus 通知浏览器它已失去焦点。
DualEngineNavigate 导航到 URL。
DualEngineNavigate2 导航到 URL，其中包含有关导航的其他信息。
DualEngineNotifyNavigationEntriesDeleted 通知导航条目已删除。
DualEnginePrepareToExitRegion 通知浏览器正在对将由主机处理的页面进行导航。
DualEnginePrint 调用当前页的“打印”对话框。
DualEngineProtectFocus 控制浏览器是否尝试将焦点更改为自身。
DualEngineSavePageAs 调用当前页的“ 保存网页 ”对话框。
DualEngineSetEngineSwitchingPolicyFlags 设置确定浏览器如何处理引擎切换的标志。
DualEngineSetFocus 在托管浏览器内设置焦点。
DualEngineSetMediaFullscreen 更改在浏览器中播放的媒体的全屏状态。
DualEngineSetPosition 设置浏览器窗口的大小和位置。
DualEngineSetTheaterFullscreen 更改浏览器的剧院模式状态。
DualEngineSetTheaterMargins 在剧院模式下显示浏览器窗口时，调整其上边距。
DualEngineSetVisible 通知浏览器可见性更改。
DualEngineSetWindowStyle 更改浏览器窗口的样式。
DualEngineSetZoom 更改浏览器的缩放值。
DualEngineSimulateKeyInput 发送模拟密钥输入。
DualEngineSimulateMouseInput 发送模拟鼠标输入。
DualEngineStopFindOnPage 停止查找作。
DualEngineTranslateAccelerator 处理快捷键消息。

适用对象

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

Members

DualEngineBrowserCommitted

通知浏览器它已提交，并且不再具有推理性。

public HRESULT DualEngineBrowserCommitted ()

DualEngineClose

关闭浏览器实例。

public HRESULT DualEngineClose ()

DualEngineDeleteTabRecoveryData

删除选项卡恢复数据。

public HRESULT DualEngineDeleteTabRecoveryData (REFGUID guidTabId)

参数
  • guidTabId 要删除的源恢复数据文件的 GUID。

DualEngineDoOnBeforeUnloadAndStop

停止正在进行的任何导航并运行 onBeforeUnload 处理程序。

public HRESULT DualEngineDoOnBeforeUnloadAndStop ()

DualEngineDPIChanged

通知 DPI 已更改，应重新计算页面布局。

public HRESULT DualEngineDPIChanged ()

DualEngineEnableCaretMode

启用或禁用插入点浏览模式。

public HRESULT DualEngineEnableCaretMode (BOOL fEnable)

参数
  • fEnable 指定是否应启用插入点浏览。

DualEngineExecNavigationCommand

执行导航命令。

public HRESULT DualEngineExecNavigationCommand (NAVIGATION_COMMAND command)

参数
  • command 要执行的导航命令。

DualEngineFindOnPage

在页面上查找文本的实例。

public HRESULT DualEngineFindOnPage (int iRequestID， LPCWSTR pszFindText， BOOL fFindNext， BOOL fForward)

参数

  • iRequestID 用于对页面请求和事件进行关联查找的 ID。

  • pszFindText 在页面上查找的文本。

  • fFindNext 指示所选内容是否应移动到查找文本的下一个实例，如果为 true，则不为 false。

  • fForward 指示选择的方向，true 向前移动，false 向后移动。

DualEngineForceClose

强制关闭浏览器实例。

public HRESULT DualEngineForceClose ()

DualEngineGeolocationPermissionResponse

提供对地理位置权限请求的响应。

public HRESULT DualEngineGeolocationPermissionResponse (LPCWSTR pszUri，SITE_PERMISSION_RESPONSE响应)

参数

  • pszUri 地理位置请求来自的 URI。

  • response 对请求的响应。

DualEngineGoToEntry

导航到特定的旅行日志条目。

public HRESULT DualEngineGoToEntry (ULONG ulEntryId)

参数
  • ulEntryId 要导航到的旅行日志条目 ID。

DualEngineInitialize

使用 URL 初始化浏览器对象。

public HRESULT DualEngineInitialize (IDualEngine20BrowserObserver * pDualEngineObserver， DUALENGINECONFIGURATION config， EngineSwitchingPolicyFlags engineSwitchingPolicyFlags， SentinelEntryInfo sentinelEntryInfo， LPCWSTR pszUrl， HWND hwndHost， HWND * phwnd)

参数

  • pDualEngineObserver 指向此浏览器的观察程序的指针。

  • config 所需浏览器行为的配置标志。

  • engineSwitchingPolicyFlags 确定如何处理引擎切换的标志。

  • sentinelEntryInfo 此实例的初始导航之前和之后的历史记录项数。

  • pszUrl 要导航到的初始 URL。

  • hwndHost 浏览器窗口将父级的主机窗口的 HWND。

  • phwnd 浏览器窗口的 HWND。

DualEngineInitialize2

使用 URL 初始化浏览器对象;此版本允许传入有关初始导航的其他信息。

public HRESULT DualEngineInitialize2 (IDualEngine20BrowserObserver * pDualEngineObserver， DUALENGINECONFIGURATION config， EngineSwitchingPolicyFlags engineSwitchingPolicyFlags， SentinelEntryInfo sentinelEntryInfo sentinelEntryInfo， LPCWSTR pszUrl， HWND hwndHost， HWND * phwnd， LPCWSTR pszReferrer， LPCWSTR pszHeaders， VARIANT * postData)

参数

  • pDualEngineObserver 指向此浏览器的观察程序的指针。

  • config 所需浏览器行为的配置标志。

  • engineSwitchingPolicyFlags 确定如何处理引擎切换的标志。

  • sentinelEntryInfo 此实例的初始导航之前和之后的历史记录项数。

  • pszUrl 要导航到的初始 URL。

  • hwndHost 浏览器窗口将父级的主机窗口的 HWND。

  • phwnd 浏览器窗口的 HWND。

  • pszReferrer 初始导航的 HTTP 引用程序请求标头。

  • pszHeaders 要发送到服务器进行初始导航的其他标头。

  • postData 作为初始导航的 HTTP POST 事务的一部分发送到服务器的数据。

DualEngineInitializeWithRecoveryData

使用选项卡恢复数据初始化浏览器对象。

public HRESULT DualEngineInitializeWithRecoveryData (REFGUID guidTabId， ULONG ulEntryId， IDualEngine20BrowserObserver * pDualEngineObserver， DUALENGINECONFIGURATION config， EngineSwitchingPolicyFlags engineSwitchingPolicyFlags， SentinelEntryInfo sentinelEntryInfo sentinelEntryInfo， LPCWSTR pszUrl， HWND hwndHost， HWND * phwnd)

参数

  • guidTabId 用于初始化此实例的源恢复数据文件的 GUID。

  • ulEntryId 恢复后要导航到的旅行日志中条目的 ID。

  • pDualEngineObserver 指向此浏览器的观察程序的指针。

  • config 所需浏览器行为的配置标志。

  • engineSwitchingPolicyFlags 确定如何处理引擎切换的标志。

  • sentinelEntryInfo 此实例的初始导航之前和之后的历史记录项数。

  • pszUrl 要导航到的初始 URL。

  • hwndHost 浏览器窗口将父级的主机窗口的 HWND。

  • phwnd 浏览器窗口的 HWND。

DualEngineLostFocus

通知浏览器它已失去焦点。

public HRESULT DualEngineLostFocus (HWND hwndLostFocus)

参数
  • hwndLostFocus 焦点移动到的窗口。

DualEngineNavigate

导航到 URL。

public HRESULT DualEngineNavigate (LPCWSTR pszUrl， BOOL fSkipOnBeforeUnload)

参数

  • pszUrl 要导航到的 URL。

  • fSkipOnBeforeUnload 是否跳过处理 onBeforeUnload 。

DualEngineNavigate2

导航到 URL，其中包含有关导航的其他信息。

public HRESULT DualEngineNavigate2 (LPCWSTR pszUrl， BOOL fSkipOnBeforeUnload， LPCWSTR pszReferrer， LPCWSTR pszHeaders， VARIANT * postData)

参数

  • pszUrl 要导航到的 URL。

  • fSkipOnBeforeUnload 是否跳过处理 onBeforeUnload 。

  • pszReferrer 此导航的 HTTP 引用程序请求标头。

  • pszHeaders 要为此导航发送到服务器的其他标头。

  • postData 要作为此导航的 HTTP POST 事务的一部分发送到服务器的数据。

DualEngineNotifyNavigationEntriesDeleted

通知导航条目已删除。

public HRESULT DualEngineNotifyNavigationEntriesDeleted (BOOL fShouldDeleteEntries， SentinelEntryInfo sentinelEntryInfo)

参数

  • fShouldDeleteEntries 指示浏览器是否应删除其列表中的所有条目。

  • sentinelEntryInfo 此实例的初始导航之前和之后的历史记录项数。

DualEnginePrepareToExitRegion

通知浏览器正在对将由主机处理的页面进行导航。

public HRESULT DualEnginePrepareToExitRegion (EXIT_REGION_TYPE type)

参数
  • type 导致此退出的导航类型。

DualEnginePrint

调用当前页的“打印”对话框。

public HRESULT DualEnginePrint ()

DualEngineProtectFocus

控制浏览器是否尝试将焦点更改为自身。

public HRESULT DualEngineProtectFocus (BOOL fProtectFocus)

参数
  • fProtectFocus 如果 true为 ，则浏览器不会尝试窃取焦点;如果 false为 ，则允许窃取焦点。

DualEngineSavePageAs

调用当前页的“ 保存网页 ”对话框。

public HRESULT DualEngineSavePageAs ()

DualEngineSetEngineSwitchingPolicyFlags

设置确定浏览器如何处理引擎切换的标志。

public HRESULT DualEngineSetEngineSwitchingPolicyFlags (EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

参数
  • engineSwitchingPolicyFlags 表示所需引擎切换行为的标志。

DualEngineSetFocus

在托管浏览器内设置焦点。

public HRESULT DualEngineSetFocus (DUALENGINE_FOCUSDIRECTION focusDirection)

参数
  • focusDirection 焦点在浏览器中移动的方向。

DualEngineSetMediaFullscreen

更改在浏览器中播放的媒体的全屏状态。

public HRESULT DualEngineSetMediaFullscreen (BOOL fFullscreen)

警告

尽管其名称为 ，但此函数仅退出全屏，如果没有媒体是全屏，则不会执行任何作。 传入 true 函数始终是无作。

参数
  • fFullscreen 如果 false为 ，则当媒体为全屏时，将退出全屏;如果 true为 ，则不会发生任何作。

DualEngineSetPosition

设置浏览器窗口的大小和位置。

public HRESULT DualEngineSetPosition (int x， int y， int iWidth， int iHeight)

参数

  • x 以客户端坐标表示的窗口左侧的新位置。

  • y 以客户端坐标表示的窗口顶部的新位置。

  • iWidth 窗口的新宽度（以像素为单位）。

  • iHeight 窗口的新高度（以像素为单位）。

DualEngineSetTheaterFullscreen

更改浏览器的剧院模式状态。

public HRESULT DualEngineSetTheaterFullscreen (BOOL fFullscreen)

在影院模式下，浏览器窗口将填满整个屏幕，并显示具有最少导航按钮集的工具栏。 屏幕右上角还提供了状态栏。 在剧院模式下，“历史记录”和“收藏夹”等资源管理器栏在屏幕左边缘显示为自动隐藏窗格。

参数
  • fFullscreen 如果 true 且当前未处于影院模式，则浏览器将进入影院模式;如果 false 且当前处于剧院模式，则浏览器将退出剧院模式。

DualEngineSetTheaterMargins

在剧院模式下显示浏览器窗口时，调整其上边距。

public HRESULT DualEngineSetTheaterMargins (BOOL fTheaterShowing， int yTheaterThreshold)

参数

  • fTheaterShowing 指示主机当前是否处于影院模式。

  • yTheaterThreshold 屏幕顶部与全屏浏览器窗口之间的边距的大小（以像素为单位）。

DualEngineSetVisible

通知浏览器可见性更改。

public HRESULT DualEngineSetVisible (BROWSERVISIBILITY 可见性)

参数
  • visibility 我们正在输入的可见性状态。

DualEngineSetWindowStyle

更改浏览器窗口的样式。

public HRESULT DualEngineSetWindowStyle (int wlStyle， int wlExStyle)

参数

  • wlStyle 要设置的“窗口样式”值。

  • wlExStyle 要设置的扩展 Windows 样式值。

DualEngineSetZoom

更改浏览器的缩放值。

public HRESULT DualEngineSetZoom (int iZoomPercent)

参数
  • iZoomPercent 要将浏览器设置为的缩放百分比。

DualEngineSimulateKeyInput

发送模拟密钥输入。

public HRESULT DualEngineSimulateKeyInput (DWORD vKey， KEYACTION keyAction)

参数

  • vKey 要模拟的虚拟密钥代码。

  • keyAction 要模拟的关键作。

DualEngineSimulateMouseInput

发送模拟鼠标输入。

public HRESULT DualEngineSimulateMouseInput (DWORD x， DWORD y， MOUSEACTION mouseAction)

参数

  • x x 坐标。

  • y y 坐标。

  • mouseAction 要模拟的鼠标作。

DualEngineStopFindOnPage

停止查找作。

public HRESULT DualEngineStopFindOnPage (BOOL fClean)

参数
  • fClean 如果 true为 ，则会清除突出显示的结果和当前所选结果;如果 false为 ，则当前所选结果将保持选中状态。

DualEngineTranslateAccelerator

处理快捷键消息。

public HRESULT DualEngineTranslateAccelerator (LPMSG lpMsg)

参数
  • lpMsg 指向 MSG 结构的指针，该结构指定要翻译的消息。
  • Last updated on