Поделиться через

интерфейс IDualEngine20Browser

Важно!

API DualEngine является частью функции ограниченного доступа (см. раздел Класс LimitedAccessFeatures). Дополнительные сведения или запрос маркера разблокировки см. в служба поддержки Майкрософт.

interface IDualEngine20Browser
  : public IUnknown

Представляет вкладку Интернет-Обозреватель.

Сводка

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 Идентификатор для использования корреляции поиска в запросах и событиях страницы.

  • 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 Идентификатор записи журнала путешествий для перехода.

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, EngineSwitchingPolicyFlags engineSwitchingPolicyFlags, 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 Referer для начальной навигации.

  • pszHeaders Дополнительные заголовки для отправки на сервер для начальной навигации.

  • postData Данные, отправляемые на сервер в рамках транзакции HTTP POST для начальной навигации.

DualEngineInitializeWithRecoveryData

Инициализирует объект браузера с помощью данных восстановления табуляции.

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

Параметры

  • guidTabId ИДЕНТИФИКАТОР GUID для исходного файла данных восстановления для инициализации этого экземпляра.

  • ulEntryId Идентификатор записи в журнале путешествий для перехода после восстановления.

  • 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 Referer для этой навигации.

  • 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)

Параметры
  • 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