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

interface IDualEngine20BrowserObserver

Важно!

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

interface IDualEngine20BrowserObserver
  : public IUnknown

Получает события из браузера.

Сводка

Members Описания
ContinueNavigationInEdge Возникает, когда браузер хочет прекратить размещение содержимого и продолжить переход по URL-адресу в процессе размещения.
ContinueNavigationInEdge2 Возникает, когда браузер хочет прекратить размещение содержимого и продолжить переход по URL-адресу в процессе размещения; эта версия предоставляет дополнительные сведения о навигации.
NavigateToOffsetInEdge Возникает, когда браузер запрашивает переход к смещению записи в журнале путешествий.
OnAllButCurrentEntryDeleted Возникает, когда браузер удалил все записи в журнале путешествий, кроме текущей записи.
OnAsyncHungCheckReply Возникает при обработке асинхронного зависания проверка сообщения, см. раздел IDualEngine20BrowserSession::SetHangDetectionMessages().
OnAttentionState Возникает при запросе внимания пользователя.
OnBeforeUnloadAndStopComplete Возникает после завершения обработки события beforeUnload.
OnCloseCompleted Возникает при закрытии браузера.
OnCloseRequested Возникает при запросе браузера на закрытие.
OnDialogShown Возникает, когда браузер отображает или скрывает модальное диалоговое окно.
OnDocumentComplete Возникает при полной загрузке и инициализации документа.
OnDocumentModeSet Возникает при изменении режима документа.
OnEnterpriseIDSet Возникает после завершения навигации; предоставляет сведения об идентификаторе предприятия.
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 Referer.

  • 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 Идентификатор для сопоставления ответа с отправленным сообщением.

OnAttentionState

Возникает при запросе внимания пользователя.

public HRESULT OnAttentionState(ATTENTIONSTATE attentionStateState)

Параметры
  • 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 Идентификатор записи журнала путешествий для страницы, на которую возникло это событие.

  • pVisibleListEntries Список, содержащий новые записи журнала путешествий с момента последнего обновления.

  • cVisibleListEntries Количество элементов в pVisibleListEntries

OnDocumentModeSet

Возникает при изменении режима документа.

public HRESULT OnDocumentModeSet(ULONG documentMode)

Параметры
  • documentMode Новая версия режима документа.

OnEnterpriseIDSet

Возникает после завершения навигации; предоставляет сведения об идентификаторе предприятия.

public HRESULT OnEnterpriseIDSet(BOOL fEnterpriseID)

Параметры
  • fEnterpriseID Указывает, установлен ли в браузере корпоративный идентификатор.

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указывает, что обработчик зарегистрирован; false указывает, что OnBeforeUnload он был удален.

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 Идентификатор, представляющий эту навигацию в списке видимых записей.

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

  • 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 Referer.

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

  • spszCurrentUrl URL-адрес страницы.

  • pIconUrls Список URL-адресов favicon.

  • cIconUrls Количество элементов в pIconUrls.

UpdateHostTitle

Возникает при обновлении заголовка страницы.

public HRESULT UpdateHostTitle(ULONG ulCurrentEntryId, LPCWSTR pszTitle)

Параметры

  • ulCurrentEntryId Идентификатор страницы в списке видимых записей, который вызвал это событие.

  • pszTitle Новое название.

UpdateSecureLockIcon

Возникает при изменении сведений о безопасности страницы.

public HRESULT UpdateSecureLockIcon(ULONG ulCurrentEntryId, SECURELOCKICON secureLockIcon)

Параметры

  • ulCurrentEntryId Запись журнала путешествий для этого изменения.

  • secureLockIcon Состояние сведений о безопасности.

  • Last updated on