Compartilhar via

interface IDualEngine20BrowserObserver

  • Artigo

Importante

A API DualEngine faz parte de uma Funcionalidade de Acesso Limitado (veja Classe LimitedAccessFeatures). Para obter mais informações ou para pedir um token de desbloqueio, contacte o Suporte da Microsoft.

interface IDualEngine20BrowserObserver
  : public IUnknown

Recebe eventos do Browser.

Resumo

Members Descrições
ContinueNavigationInEdge Gerado quando o browser quer parar de alojar conteúdo e fazer com que a navegação para o URL continue no processo de alojamento.
ContinueNavigationInEdge2 Gerado quando o browser quer parar de alojar conteúdo e fazer com que a navegação para o URL continue no processo de alojamento; esta versão fornece informações adicionais sobre a navegação.
NavigateToOffsetInEdge Gerado quando o browser pede para navegar para um deslocamento de entrada de registo de viagens.
OnAllButCurrentEntryDeleted Gerado quando o browser eliminou todas as entradas no respetivo registo de viagens, exceto a entrada atual.
OnAsyncHungCheckReply Gerado quando o browser processa uma mensagem de verificação de bloqueio assíncrona, consulte IDualEngine20BrowserSession::SetHangDetectionMessages().
OnAttentionState Gerado ao pedir a atenção do utilizador.
OnBeforeUnloadAndStopComplete Gerado quando o evento beforeUnload terminar de ser processado.
OnCloseCompleted Gerado quando o browser é fechado.
OnCloseRequested Gerado quando o browser pediu para fechar.
OnDialogShown Gerado quando um browser mostra ou oculta uma caixa de diálogo modal.
OnDocumentComplete Gerado quando um documento é completamente carregado e inicializado.
OnDocumentModeSet Gerado quando o modo de documento foi alterado.
OnEnterpriseIDSet Gerado quando uma navegação é concluída; fornece informações sobre o ID da empresa.
OnFindOnPageResult Gerado quando se encontra na alteração dos resultados da página.
OnFinishedSetFocus Gerado quando um pedido IDualEngine20Browser::D ualEngineSetFocus() tiver terminado de ser processado.
OnGeolocationFeatureInUse Gerado quando os dados de geolocalização são acedidos.
OnGeolocationPermissionRequested Gerado quando é necessária permissão de utilizador para ativar a geolocalização.
OnHasBeforeUnloadChanged Gerado quando um OnBeforeUnload processador foi registado ou removido.
OnIndicatorItemsSet Gerado quando uma navegação é concluída; fornece informações de estado sobre o estado atual da página do browser.
OnInputAttempted Gerado quando a entrada do utilizador é recebida.
OnLoadingActivityChanged Gerado quando o estado de carregamento da página é alterado.
OnMixedContentBlocked Gerado quando o Conteúdo Misto foi bloqueado.
OnNavigationComplete Gerado quando uma navegação é concluída.
OnNavigationFailed Gerado quando uma navegação falha.
OnNavigationToDownload Gerado quando uma navegação termina numa transferência.
OnNewWindow Gerado quando é criada uma nova janela.
OnPopupBlocked Gerado quando uma janela de pop-up foi bloqueada.
OnPrepareToExitRegionFailed Gerado quando o browser não conseguiu processar uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().
OnReadyToExitRegion Gerado quando o browser lidou com êxito com uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().
OnTabCrashed Gerado quando o separador falhou.
OnTabHangReported Gerado quando o browser é bloqueado.
OnUnexpectedRundown Gerado quando o browser fechou inesperadamente.
OnUnhandledKeyboardAccelerator Gerado ao processar um acelerador de teclado e é determinado que o browser não processa ou não deve basear-se rgHostPriorityAccelsnesse acelerador.
OnUnhandledKeyboardAcceleratorAsync Gerado ao processar um acelerador de teclado e é determinado que o browser não processa ou não deve basear-se no rgHostPriorityAccelsacelerador.
OnVisibleComplete Gerado quando o conteúdo da página está a ser tornado visível.
OnZoomChanged Aumentado quando o zoom é alterado.
OpenURLInEdge Gerado quando o browser está a pedir ao anfitrião para navegar para um URL numa nova janela.
OpenURLInEdge2 Gerado quando o browser está a pedir ao anfitrião para navegar para um URL numa nova janela; esta versão fornece informações adicionais sobre a navegação.
RequestHostAddFavorite Gerado quando uma página é pedida para ser adicionada aos favoritos.
RequestHostCreateUrlTip Gerado ao pedir para mostrar uma descrição que contém um URL.
RequestHostFocus Gerado quando o foco está a ser pedido para mover para a janela do anfitrião.
RequestHostFullscreen Gerado quando a página está a pedir que o anfitrião apresente conteúdo em ecrã inteiro.
RequestHostHideUrlTip Gerado ao pedir para ocultar uma descrição que contém um URL.
RequestHostPositionChanged Gerado quando o browser pede que o anfitrião altere o respetivo tamanho ou posição.
RequestHostShowTheater Gerado quando o browser está a pedir ao anfitrião para entrar ou sair do modo de teatro.
RequestHostWindowFocus Gerado quando o anfitrião é pedido para assumir ou desistir do foco.
RequestHostWindowFocusSync Gerado quando o anfitrião é pedido para assumir ou desistir do foco.
UpdateHostFavicon Gerado quando a favicon mudou.
UpdateHostTitle Gerado quando o título da página tiver sido atualizado.
UpdateSecureLockIcon Gerado quando as informações de segurança da página foram alteradas.

Aplicável a

Produto Introduzido
Windows 10, Versão 20H1 KB5032278
Windows 11, versão 22H2 KB5032288

Members

ContinueNavigationInEdge

Gerado quando o browser quer parar de alojar conteúdo e fazer com que a navegação para o URL continue no processo de alojamento.

public HRESULT ContinueNavigationInEdge(LPCWSTR pszUrl, ULONG ulCookieSyncVersion)

Parâmetros

  • pszUrl O URL para o qual deve ser navegado.

  • ulCookieSyncVersion Um número que pode ser utilizado para correlacionar uma navegação com um estado de cookie específico.

ContinueNavigationInEdge2

Gerado quando o browser quer parar de alojar conteúdo e fazer com que a navegação para o URL continue no processo de alojamento; esta versão fornece informações adicionais sobre a navegação.

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

Parâmetros

  • pszUrl O URL para o qual deve ser navegado.

  • ulCookieSyncVersion Um número que pode ser utilizado para correlacionar uma navegação com um estado de cookie específico.

  • pszReferrer O cabeçalho do pedido do Referer HTTP.

  • pszHeaders Cabeçalhos HTTP adicionais.

  • postData Dados HTTP POST, como dados de formulário.

Gerado quando o browser pede para navegar para um deslocamento de entrada de registo de viagens.

public HRESULT NavigateToOffsetInEdge(int iOffset)

Parâmetros
  • iOffset O deslocamento para onde navegar.

OnAllButCurrentEntryDeleted

Gerado quando o browser eliminou todas as entradas no respetivo registo de viagens, exceto a entrada atual.

public HRESULT OnAllButCurrentEntryDeleted(VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Parâmetros

  • pVisibleListEntries Uma lista que contém as novas entradas de registo de viagens desde a última atualização. Neste caso, terá apenas a entrada ativa atual.

  • cVisibleListEntries O número de itens em pVisibleListEntries

OnAsyncHungCheckReply

Gerado quando o browser processa uma mensagem de verificação de bloqueio assíncrona, consulte IDualEngine20BrowserSession::SetHangDetectionMessages().

public HRESULT OnAsyncHungCheckReply(ULONG correlationId)

Parâmetros
  • correlationId ID para correlacionar a resposta com a mensagem enviada.

OnAttentionState

Gerado ao pedir a atenção do utilizador.

public HRESULT OnAttentionState(ATTENTIONSTATE attentionState)

Parâmetros
  • attentionState O motivo pelo qual a atenção do utilizador está a ser pedida.

OnBeforeUnloadAndStopComplete

Gerado quando o evento beforeUnload terminar de ser processado.

public HRESULT OnBeforeUnloadAndStopComplete(BOOL agreeToClose)

Parâmetros
  • agreeToClose Indica se o utilizador concordou em sair da página.

OnCloseCompleted

Gerado quando o browser é fechado.

public HRESULT OnCloseCompleted()

OnCloseRequested

Gerado quando o browser pediu para fechar.

public HRESULT OnCloseRequested()

OnDialogShown

Gerado quando um browser mostra ou oculta uma caixa de diálogo modal.

public HRESULT OnDialogShown(BOOL fShown)

Parâmetros
  • fShown Indica se a caixa de diálogo foi apresentada ou oculta.

OnDocumentComplete

Gerado quando um documento é completamente carregado e inicializado.

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

Parâmetros

  • ulCurrentEntryId O ID de entrada do registo de viagens para a página que elevou este evento.

  • pVisibleListEntries Uma lista que contém as novas entradas de registo de viagens desde a última atualização.

  • cVisibleListEntries O número de itens em pVisibleListEntries

OnDocumentModeSet

Gerado quando o modo de documento foi alterado.

public HRESULT OnDocumentModeSet(ULONG documentMode)

Parâmetros
  • documentMode A nova versão do modo de documento.

OnEnterpriseIDSet

Gerado quando uma navegação é concluída; fornece informações sobre o ID da empresa.

public HRESULT OnEnterpriseIDSet(BOOL fEnterpriseID)

Parâmetros
  • fEnterpriseID Indica se o browser tem um ID empresarial definido.

OnFindOnPageResult

Gerado quando se encontra na alteração dos resultados da página.

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

Parâmetros

OnFinishedSetFocus

Gerado quando um pedido IDualEngine20Browser::D ualEngineSetFocus() tiver terminado de ser processado.

public HRESULT OnFinishedSetFocus()

OnGeolocationFeatureInUse

Gerado quando os dados de geolocalização são acedidos.

public HRESULT OnGeolocationFeatureInUse(LPCWSTR pszContextUrl, SITE_PERMISSION_FEATURE_MODE featureMode)

Parâmetros

  • pszContextUrl O URL da página que acede aos dados de geolocalização.

  • featureMode Indica se o acesso foi bloqueado ou permitido.

OnGeolocationPermissionRequested

Gerado quando é necessária permissão de utilizador para ativar a geolocalização.

public HRESULT OnGeolocationPermissionRequested(LPCWSTR pszContextUrl)

Parâmetros
  • pszContextUrl O URL da página a pedir permissão de geolocalização.

OnHasBeforeUnloadChanged

Gerado quando um OnBeforeUnload processador foi registado ou removido.

public HRESULT OnHasBeforeUnloadChanged(BOOL fBeforeUnload)

Parâmetros
  • fBeforeUnload true indica que um OnBeforeUnload processador foi registado; false indica que foi removido.

OnIndicatorItemsSet

Gerado quando uma navegação é concluída; fornece informações de estado sobre o estado atual da página do browser.

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

Parâmetros

  • fProtectedMode Indica se o browser está no Modo Protegido.

  • fEnhancedProtectedMode Indica se o browser está no Modo Protegido Avançado.

  • dwUrlZone A zona do URL atual.

  • fEnterpriseMode Indica se o browser está no Modo Empresarial.

OnInputAttempted

Gerado quando a entrada do utilizador é recebida.

public HRESULT OnInputAttempted()

OnLoadingActivityChanged

Gerado quando o estado de carregamento da página é alterado.

public HRESULT OnLoadingActivityChanged(BOOL fLoading)

Parâmetros
  • fLoading Indica se a página está a carregar ou não.

OnMixedContentBlocked

Gerado quando o Conteúdo Misto foi bloqueado.

public HRESULT OnMixedContentBlocked()

OnNavigationComplete

Gerado quando uma navegação é concluída.

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

Parâmetros

  • guidTabId O GUID de recuperação para o separador.

  • ulCurrentEntryId O ID que representa esta navegação na lista de entradas visíveis.

  • pVisibleListEntries Uma lista que contém as novas entradas de registo de viagens desde a última atualização.

  • cVisibleListEntries O número de itens em pVisibleListEntries.

  • dwNavFlags Sinalizadores que indicam o tipo de navegação que ocorreu.

  • secureLockIcon O estado de segurança da página.

  • dwSecurityFlags Sinalizadores que indicam erros de certificado para a página.

  • pDualEngineCertificates Uma lista que contém a cadeia de certificados da página da entrada atual.

  • cCertificateChainBlobs O número de itens em pDualEngineCertificates.

OnNavigationFailed

Gerado quando uma navegação falha.

public HRESULT OnNavigationFailed(NAVIGATIONFAILEDREASON failureReason)

Parâmetros
  • failureReason A razão pela qual a navegação falhou.

OnNavigationToDownload

Gerado quando uma navegação termina numa transferência.

public HRESULT OnNavigationToDownload()

OnNewWindow

Gerado quando é criada uma nova janela.

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

Parâmetros

  • pNewBrowser O objeto do browser da nova janela.

  • hwnd A alça da nova janela.

  • options As opções com as quais a nova janela foi criada.

  • ppObserver O objeto de observador para a nova janela.

OnPopupBlocked

Gerado quando uma janela de pop-up foi bloqueada.

public HRESULT OnPopupBlocked(LPCWSTR pszContextUrl, LPCWSTR pszPopupUrl)

Parâmetros

  • pszContextUrl O URL da página que emitiu o comando para abrir o pop-up.

  • pszPopupUrl O URL da página de pop-up.

OnPrepareToExitRegionFailed

Gerado quando o browser não conseguiu processar uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

public HRESULT OnPrepareToExitRegionFailed()

OnReadyToExitRegion

Gerado quando o browser lidou com êxito com uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

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

Parâmetros

  • guidClonedTabId O GUID do ficheiro de dados de recuperação de separadores que suporta a região de saída.

  • ulCurrentEntryId O ID de entrada do registo de viagens para a página que elevou este evento.

  • pVisibleListEntriesComplete Uma lista que contém as novas entradas de registo de viagens desde a última atualização.

  • cVisibleListEntriesComplete O número de itens em pVisibleListEntriesComplete

OnTabCrashed

Gerado quando o separador falhou.

public HRESULT OnTabCrashed(BOOL fUnrecoverable)

Parâmetros
  • fUnrecoverable Indica se o separador é recuperável.

OnTabHangReported

Gerado quando o browser é bloqueado.

public HRESULT OnTabHangReported()

OnUnexpectedRundown

Gerado quando o browser fechou inesperadamente.

public HRESULT OnUnexpectedRundown()

OnUnhandledKeyboardAccelerator

Gerado ao processar um acelerador de teclado e é determinado que o browser não processa ou não deve basear-se rgHostPriorityAccelsnesse acelerador.

public HRESULT OnUnhandledKeyboardAccelerator(LPMSG lpMsg)

Parâmetros
  • lpMsg A mensagem win32 para o acelerador de teclado não processado.

OnUnhandledKeyboardAcceleratorAsync

Gerado ao processar um acelerador de teclado e é determinado que o browser não processa ou não deve basear-se no rgHostPriorityAccelsacelerador.

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

Nesta versão do método, o evento é gerado de forma assíncrona e o estado do teclado pode ter sido alterado desde que foi processado, pelo que o estado das teclas modificadoras é fornecido.

Parâmetros

  • pMsg A mensagem win32 para o acelerador de teclado não processado.

  • isShiftDown Indica se a tecla Shift foi premida.

  • isCtrlDown Indica se a tecla Ctrl foi premida.

  • isAltDown Indica se a tecla Alt foi premida.

OnVisibleComplete

Gerado quando o conteúdo da página está a ser tornado visível.

public HRESULT OnVisibleComplete()

OnZoomChanged

Aumentado quando o zoom é alterado.

public HRESULT OnZoomChanged(ULONG ulZoomPercent)

Parâmetros
  • ulZoomPercent A nova percentagem de zoom.

OpenURLInEdge

Gerado quando o browser está a pedir ao anfitrião para navegar para um URL numa nova janela.

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

Parâmetros

  • pszUrl O URL para onde navegar.

  • options Opções a aplicar à nova janela.

  • ulCookieSyncVersion Um número que pode ser utilizado para correlacionar uma navegação com um estado de cookie específico.

OpenURLInEdge2

Gerado quando o browser está a pedir ao anfitrião para navegar para um URL numa nova janela; esta versão fornece informações adicionais sobre a navegação.

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

Parâmetros

  • pszUrl O URL para onde navegar.

  • options Opções a aplicar à navegação.

  • ulCookieSyncVersion Um número que pode ser utilizado para correlacionar uma navegação com um estado de cookie específico.

  • pszReferrer O cabeçalho do pedido do Referer HTTP.

  • pszHeaders Cabeçalhos HTTP adicionais.

  • postData Dados HTTP POST, como dados de formulário.

RequestHostAddFavorite

Gerado quando uma página é pedida para ser adicionada aos favoritos.

public HRESULT RequestHostAddFavorite(LPCWSTR pszTitle, LPCWSTR pszUrl)

Parâmetros

  • pszTitle O título da página.

  • pszUrl O URL da página.

RequestHostCreateUrlTip

Gerado ao pedir para mostrar uma descrição que contém um URL.

public HRESULT RequestHostCreateUrlTip(LPCWSTR pszUrl)

Parâmetros
  • pszUrl O URL a apresentar na descrição.

RequestHostFocus

Gerado quando o foco está a ser pedido para mover para a janela do anfitrião.

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

Parâmetros

  • focusDirection A direção em que o foco está a mover-se.

  • msg Um ponteiro para a mensagem que causou a alteração do foco.

RequestHostFullscreen

Gerado quando a página está a pedir que o anfitrião apresente conteúdo em ecrã inteiro.

public HRESULT RequestHostFullscreen(FULLSCREENACTION fullScreenAction)

Parâmetros
  • fullScreenAction A ação de ecrã inteiro que está a ser pedida.

RequestHostHideUrlTip

Gerado ao pedir para ocultar uma descrição que contém um URL.

public HRESULT RequestHostHideUrlTip()

RequestHostPositionChanged

Gerado quando o browser pede que o anfitrião altere o respetivo tamanho ou posição.

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

Parâmetros

  • nX A posição da janela X pedida.

  • nY A posição da janela Y pedida.

  • nWidth A largura da janela pedida.

  • nHeight A altura da janela pedida.

  • hSyncEvent Um identificador para o objeto de evento que deve ser sinalizado quando a alteração estiver concluída.

RequestHostShowTheater

Gerado quando o browser está a pedir ao anfitrião para entrar ou sair do modo de teatro.

public HRESULT RequestHostShowTheater(BOOL fShow)

Parâmetros
  • fShow Se true, o anfitrião está a ser solicitado para entrar no modo de teatro; se false, está a ser pedido para sair do modo de teatro.

RequestHostWindowFocus

Gerado quando o anfitrião é pedido para assumir ou desistir do foco.

public HRESULT RequestHostWindowFocus(BOOL fFocus)

Parâmetros
  • fFocus Indica o que deve ser feito com o foco. Se true, o foco deve ser tomado; caso contrário, deve ser abandonado.

RequestHostWindowFocusSync

Gerado quando o anfitrião é pedido para assumir ou desistir do foco.

public HRESULT RequestHostWindowFocusSync(BOOL fFocus, ULONGLONG hSyncEvent)

Nesta versão do método, o browser aguardará até que o evento fornecido seja sinalizado.

Parâmetros

  • fFocus Indica o que deve ser feito com o foco. Se true, o foco deve ser tomado; caso contrário, deve ser abandonado.

  • hSyncEvent Um identificador para o objeto de evento que deve ser sinalizado quando a alteração estiver concluída.

UpdateHostFavicon

Gerado quando a favicon mudou.

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

Parâmetros

  • ulCurrentEntryId O ID de entrada do registo de viagens para a página que elevou este evento.

  • spszCurrentUrl O URL da página.

  • pIconUrls Uma lista de URLs de favicon.

  • cIconUrls O número de itens em pIconUrls.

UpdateHostTitle

Gerado quando o título da página tiver sido atualizado.

public HRESULT UpdateHostTitle(ULONG ulCurrentEntryId, LPCWSTR pszTitle)

Parâmetros

  • ulCurrentEntryId O ID da página na lista visível-entradas que elevou este evento.

  • pszTitle O novo título.

UpdateSecureLockIcon

Gerado quando as informações de segurança da página foram alteradas.

public HRESULT UpdateSecureLockIcon(ULONG ulCurrentEntryId, SECURELOCKICON secureLockIcon)

Parâmetros

  • ulCurrentEntryId A entrada do registo de viagens para esta alteração.

  • secureLockIcon O estado das informações de segurança.