interface IDualEngine20BrowserObserver

interface IDualEngine20BrowserObserver
  : public IUnknown

Recebe eventos do Navegador.

Resumo

Aplicável a

Members

ContinueNavigationInEdge

Gerado quando o navegador deseja parar de hospedar conteúdo e fazer com que a navegação para a URL continue no processo de hospedagem.

público HRESULT ContinueNavigationInEdge(LPCWSTR pszUrl, ULONG ulCookieSyncVersion)

Parâmetros

• pszUrl A URL para a qual você deve navegar.

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

ContinueNavigationInEdge2

Gerado quando o navegador deseja parar de hospedar conteúdo e fazer com que a navegação para a URL continue no processo de hospedagem; Esta versão fornece informações adicionais sobre a navegação.

público HRESULT ContinueNavigationInEdge2(LPCWSTR pszUrl, ULONG ulCookieSyncVersion, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parâmetros

• pszUrl A URL para a qual você deve navegar.

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

• pszReferrer O cabeçalho de solicitação do Referenciador HTTP.

• pszHeaders Cabeçalhos HTTP adicionais.

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

NavigateToOffsetInEdge

Gerado quando o navegador solicita a navegação para um deslocamento de entrada de registro de viagem.

public HRESULT NavigateToOffsetInEdge(int iOffset)

Parâmetros

• iOffset O deslocamento para o qual navegar.

OnAllButCurrentEntryDeleted

Gerado quando o navegador excluiu todas as entradas em seu registro de viagens, exceto a entrada atual.

público HRESULT OnAllButCurrentEntryDeleted(VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Parâmetros

• pVisibleListEntries Uma lista contendo as novas entradas de registro de viagem desde a última atualização. Nesse caso, ele terá apenas a entrada ativa atual.

• cVisibleListEntries O número de itens na pVisibleListEntries

OnAsyncHungCheckReply

Gerado quando o navegador processa uma mensagem de verificação de travamento assíncrono de marcação, consulte IDualEngine20BrowserSession::SetHangDetectionMessages().

público HRESULT OnAsyncHungCheckReply(ULONG correlationId)

Parâmetros

• correlationId ID para correlacionar a resposta com a mensagem enviada.

OnAttentionState

Gerado ao solicitar a atenção do usuário.

público HRESULT OnAttentionState(ATTENTIONSTATE, attentionState)

Parâmetros

• attentionState O motivo pelo qual a atenção do usuário está sendo solicitada.

OnBeforeUnloadAndStopComplete

Gerado quando o evento beforeUnload termina de ser processado.

público HRESULT OnBeforeUnloadAndStopComplete(BOOL agreeToClose)

Parâmetros

• agreeToClose Indica se o usuário concordou em sair da página.

OnCloseCompleted

Gerado quando o navegador é fechado.

public HRESULT OnCloseCompleted()

OnCloseRequested

Gerado quando o navegador solicita o fechamento.

public HRESULT OnCloseRequested()

OnDialogShown

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

público HRESULT OnDialogShown(BOOL fShown)

Parâmetros

• fShown Indica se a caixa de diálogo foi mostrada ou oculta.

OnDocumentComplete

Gerado quando um documento é completamente carregado e inicializado.

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

Parâmetros

• ulCurrentEntryId A ID da entrada de registro de viagem da página que gerou esse evento.

• pVisibleListEntries Uma lista contendo as novas entradas de registro de viagem desde a última atualização.

• cVisibleListEntries O número de itens na pVisibleListEntries

OnDocumentModeSet

Gerado quando o modo de documento é alterado.

público HRESULT OnDocumentModeSet(ULONG documentMode)

Parâmetros

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

OnEnterpriseIDSet

Gerado quando uma navegação foi concluída; fornece informações sobre a ID da Empresa.

público HRESULT OnEnterpriseIDSet(BOOL fEnterpriseID)

Parâmetros

• fEnterpriseID Indica se o navegador possui uma Enterprise ID definida.

OnFindOnPageResult

Gerado quando os resultados da localização na página mudam.

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

Parâmetros

• iRequestID Um ID para correlacionar resultados com solicitações IDualEngine20Browser::D ualEngineFindOnPage( ).

• cMatches A contagem de correspondências.

• iActiveMatch O índice da correspondência selecionada.

OnFinishedSetFocus

Gerado quando uma solicitação IDualEngine20Browser::D ualEngineSetFocus() termina de ser processada.

public HRESULT OnFinishedSetFocus()

OnGeolocationFeatureInUse

Gerado quando dados de geolocalização são acessados.

público HRESULT OnGeolocationFeatureInUse(LPCWSTR, pszContextUrl, SITE_PERMISSION_FEATURE_MODE featureMode)

Parâmetros

• pszContextUrl A URL da página que acessa os dados de geolocalização.

• featureMode Indica se o acesso foi bloqueado ou permitido.

OnGeolocationPermissionRequested

Gerado quando a permissão do usuário é necessária para habilitar a geolocalização.

público HRESULT OnGeolocationPermissionRequested(LPCWSTR pszContextUrl)

Parâmetros

• pszContextUrl A URL da página que solicita permissão de geolocalização.

OnHasBeforeUnloadChanged

Gerado quando um OnBeforeUnload manipulador foi registrado ou removido.

público HRESULT OnHasBeforeUnloadChanged(BOOL fBeforeUnload)

Parâmetros

• fBeforeUnload true Indica que um OnBeforeUnload manipulador foi registrado; false indica que ele foi removido.

OnIndicatorItemsSet

Gerado quando uma navegação foi concluída; Fornece informações de status sobre o estado atual da página do navegador.

público HRESULT OnIndicatorItemsSet(BOOL fProtectedMode, BOOL fEnhancedProtectedMode, DWORD dwUrlZone, BOOL fEnterpriseMode)

Parâmetros

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

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

• dwUrlZone A zona da URL atual.

• fEnterpriseMode Indica se o navegador está no modo Empresarial.

OnInputAttempted

Gerado quando a entrada do usuário é recebida.

public HRESULT OnInputAttempted()

OnLoadingActivityChanged

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

público HRESULT OnLoadingActivityChanged(BOOL fLoading)

Parâmetros

• fLoading Indica se a página está carregando ou não.

OnMixedContentBlocked

Gerado quando o conteúdo misto foi bloqueado.

public HRESULT OnMixedContentBlocked()

OnNavigationComplete

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

público 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 da guia.

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

• pVisibleListEntries Uma lista contendo as novas entradas de registro de viagem desde a última atualização.

• cVisibleListEntries O número de itens no pVisibleListEntriesformato .

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

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

• dwSecurityFlags Sinalizadores indicando quaisquer erros de certificado para a página.

• pDualEngineCertificates Uma lista contendo a cadeia de certificados para a página da entrada atual.

• cCertificateChainBlobs O número de itens no pDualEngineCertificatesformato .

OnNavigationFailed

Gerado quando uma navegação falha.

público HRESULT OnNavigationFailed(NAVIGATIONFAILEDREASON failureReason)

Parâmetros

• failureReason O motivo da falha na navegação.

OnNavigationToDownload

Gerado quando uma navegação termina em um download.

public HRESULT OnNavigationToDownload()

OnNewWindow

Gerado quando uma nova janela é criada.

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

Parâmetros

• pNewBrowser O objeto do navegador para a nova janela.

• hwnd O identificador da nova janela.

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

• ppObserver O objeto observador para a nova janela.

OnPopupBlocked

Gerado quando uma janela pop-up foi bloqueada.

public HRESULT OnPopupBlocked(LPCWSTR, pszContextUrl, LPCWSTR, pszPopupUrl)

Parâmetros

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

• pszPopupUrl A URL da página pop-up.

OnPrepareToExitRegionFailed

Gerado quando o navegador não conseguiu manipular uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

public HRESULT OnPrepareToExitRegionFailed()

OnReadyToExitRegion

Gerado quando o navegador manipulou com êxito uma chamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

público HRESULT OnReadyToExitRegion(REFGUID guidClonedTabId, ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntriesComplete, int cVisibleListEntriesComplete)

Parâmetros

• guidClonedTabId O GUID do arquivo de dados de recuperação de guia que dá suporte à região encerrada.

• ulCurrentEntryId A ID da entrada de registro de viagem da página que gerou esse evento.

• pVisibleListEntriesComplete Uma lista contendo as novas entradas de registro de viagem desde a última atualização.

• cVisibleListEntriesComplete O número de itens na pVisibleListEntriesComplete

OnTabCrashed

Gerado quando a guia falha.

público HRESULT OnTabCrashed(BOOL fUnrecoverable)

Parâmetros

• fUnrecoverable Indica se a guia é recuperável.

OnTabHangReported

Gerado quando o navegador trava.

public HRESULT OnTabHangReported()

OnUnexpectedRundown

Gerado quando o navegador é fechado inesperadamente.

public HRESULT OnUnexpectedRundown()

OnUnhandledKeyboardAccelerator

Gerado ao processar um acelerador de teclado e é determinado que o navegador não manipula ou não deve se basear em rgHostPriorityAccels, esse acelerador.

público HRESULT OnUnhandledKeyboardAccelerator(LPMSG lpMsg)

Parâmetros

• lpMsg A mensagem win32 para o acelerador de teclado sem tratamento.

OnUnhandledKeyboardAcceleratorAsync

Gerado ao processar um acelerador de teclado e é determinado que o navegador não manipula, ou não deve se basear em rgHostPriorityAccels, manipular esse acelerador.

público 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, portanto, o estado das teclas modificadoras é fornecido.

Parâmetros

• pMsg A mensagem win32 para o acelerador de teclado sem tratamento.

• isShiftDown Indica se a tecla Shift foi pressionada.

• isCtrlDown Indica se a tecla Ctrl foi pressionada.

• isAltDown Indica se a tecla Alt foi pressionada.

OnVisibleComplete

Gerado quando o conteúdo da página está se tornando visível.

public HRESULT OnVisibleComplete()

OnZoomChanged

Gerado quando o zoom é alterado.

público HRESULT OnZoomChanged(ULONG ulZoomPercent)

Parâmetros

• ulZoomPercent A nova porcentagem de zoom.

OpenURLInEdge

Gerado quando o navegador está solicitando que o host navegue até uma URL em uma nova janela.

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

Parâmetros

• pszUrl A URL para a qual navegar.

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

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

OpenURLInEdge2

Gerado quando o navegador está solicitando que o host navegue até uma URL em uma 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 A URL para a qual navegar.

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

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

• pszReferrer O cabeçalho de solicitação do Referenciador HTTP.

• pszHeaders Cabeçalhos HTTP adicionais.

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

RequestHostAddFavorite

Gerado quando uma página é solicitada a ser adicionada aos favoritos.

público HRESULT RequestHostAddFavorite(LPCWSTR pszTitle, LPCWSTR pszUrl)

Parâmetros

• pszTitle O título da página.

• pszUrl A URL da página.

RequestHostCreateUrlTip

Gerado ao solicitar a exibição de uma dica de ferramenta contendo uma URL.

public HRESULT RequestHostCreateUrlTip(LPCWSTR pszUrl)

Parâmetros

• pszUrl A URL a ser exibida na dica de ferramenta.

RequestHostFocus

Gerado quando o foco está sendo solicitado para mover para a janela do host.

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

Parâmetros

• focusDirection A direção em que o foco está se movendo.

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

RequestHostFullscreen

Gerado quando a página solicita que o host exiba o conteúdo em tela inteira.

público, HRESULT, RequestHostFullscreen(FULLSCREENACTION, fullScreenAction)

Parâmetros

• fullScreenAction A ação de tela inteira que está sendo solicitada.

RequestHostHideUrlTip

Gerado ao solicitar a ocultação de uma dica de ferramenta contendo uma URL.

public HRESULT RequestHostHideUrlTip()

RequestHostPositionChanged

Gerado quando o navegador solicita que o host altere seu tamanho ou posição.

público HRESULT RequestHostPositionChanged(LONG nX, LONG nY, LONG nWidth, LONG nHeight, ULONGLONG hSyncEvent)

Parâmetros

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

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

• nWidth A largura da janela solicitada.

• nHeight A altura da janela solicitada.

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

RequestHostShowTheater

Gerado quando o navegador está solicitando que o host entre ou saia do modo teatro.

public HRESULT RequestHostShowTheater(BOOL fShow)

Parâmetros

• fShow Se true, o host está sendo solicitado a entrar no modo de teatro; se false, está sendo solicitado a sair do modo de teatro.

RequestHostWindowFocus

Gerado quando o host é solicitado a assumir ou desistir do foco.

público HRESULT RequestHostWindowFocus(BOOL fFocus)

Parâmetros

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

RequestHostWindowFocusSync

Gerado quando o host é solicitado a assumir ou desistir do foco.

público HRESULT RequestHostWindowFocusSync(BOOL fFocus, ULONGLONG hSyncEvent)

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

Parâmetros

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

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

UpdateHostFavicon

Gerado quando o favicon mudou.

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

Parâmetros

• ulCurrentEntryId A ID da entrada de registro de viagem da página que gerou esse evento.

• spszCurrentUrl A URL da página.

• pIconUrls Uma lista de URLs de favicon.

• cIconUrls O número de itens no pIconUrlsformato .

UpdateHostTitle

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

público HRESULT UpdateHostTitle(ULONG ulCurrentEntryId, LPCWSTR pszTitle)

Parâmetros

• ulCurrentEntryId A ID da página na lista de entradas visíveis que gerou esse evento.

• pszTitle O novo título.

UpdateSecureLockIcon

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

público HRESULT UpdateSecureLockIcon(ULONG ulCurrentEntryId, SECURELOCKICON secureLockIcon)

Parâmetros

• ulCurrentEntryId A entrada do diário de viagem para essa alteração.

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