interface IDualEngine20Browser

Importante

A API DualEngine faz parte de um Recurso de Acesso Limitado (consulte a classe LimitedAccessFeatures). Para obter mais informações ou solicitar um token de desbloqueio, entre em contato com o Suporte da Microsoft.

interface IDualEngine20Browser
  : public IUnknown

Representa uma guia do Internet Explorer.

Resumo

Members Descrições
DualEngineBrowserCommitted Notifica o navegador de que ele foi confirmado e não é mais especulativo.
DualEngineClose Fecha a instância do navegador.
DualEngineDeleteTabRecoveryData Exclui dados de recuperação de guia.
DualEngineDoOnBeforeUnloadAndStop Interrompe todas as navegações que estão em andamento e executa os onBeforeUnload manipuladores.
DualEngineDPIChanged Notifica que o DPI foi alterado e o layout da página deve ser recalculado.
DualEngineEnableCaretMode Habilita ou desabilita o modo de navegação com cursor.
DualEngineExecNavigationCommand Executa um comando de navegação.
DualEngineFindOnPage Localiza uma instância de texto na página.
DualEngineForceClose Forçar o fechamento da instância do navegador.
DualEngineGeolocationPermissionResponse Fornece uma resposta a uma solicitação de permissão de geolocalização.
DualEngineGoToEntry Navega para uma entrada de registro de viagem específica.
DualEngineInitialize Inicializa o objeto do navegador com uma URL.
DualEngineInitialize2 Inicializa o objeto do navegador com uma URL; Esta versão permite que informações adicionais sobre a navegação inicial sejam passadas.
DualEngineInitializeWithRecoveryData Inicializa o objeto do navegador usando dados de recuperação de tabulação.
DualEngineLostFocus Notifica o navegador de que ele perdeu o foco.
DualEngineNavigate Navega até uma URL.
DualEngineNavigate2 Navega até uma URL, com informações adicionais sobre a navegação.
DualEngineNotifyNavigationEntriesDeleted Notifica que as entradas de navegação foram excluídas.
DualEnginePrepareToExitRegion Notifica o navegador de que uma navegação está ocorrendo em uma página que será manipulada pelo host.
DualEnginePrint Invoca a caixa de diálogo Imprimir da página atual.
DualEngineProtectFocus Controla se o navegador tenta alterar o foco para si mesmo.
DualEngineSavePageAs Invoca a caixa de diálogo Salvar página da Web para a página atual.
DualEngineSetEngineSwitchingPolicyFlags Define sinalizadores que determinam como o navegador lida com a alternância de mecanismo.
DualEngineSetFocus Define o foco dentro do navegador hospedado.
DualEngineSetMediaFullscreen Altera o estado de tela inteira da mídia reproduzida no navegador.
DualEngineSetPosition Define o tamanho e a posição da janela do navegador.
DualEngineSetTheaterTela inteira Altera o estado do modo Teatro do navegador.
DualEngineSetTheaterMargins Ajusta a margem superior da janela do navegador quando ela está sendo exibida no modo de teatro.
DualEngineSetVisible Notifica o navegador sobre uma alteração de visibilidade.
DualEngineSetWindowStyle Altera o estilo da janela do navegador.
DualEngineSetZoom Altera o valor de zoom do navegador.
DualEngineSimulateKeyInput Envia uma entrada de chave simulada.
DualEngineSimulateMouseInput Envia uma entrada de mouse simulada.
DualEngineStopFindOnPage Interrompe a operação de localização.
DualEngineTranslateAccelerator Processa uma mensagem de acelerador.

Aplicável a

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

Members

DualEngineBrowserCommitted

Notifica o navegador de que ele foi confirmado e não é mais especulativo.

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Fecha a instância do navegador.

public HRESULT DualEngineClose()

DualEngineDeleteTabRecoveryData

Exclui dados de recuperação de guia.

público HRESULT DualEngineDeleteTabRecoveryData(REFGUID, guidTabId)

Parâmetros
  • guidTabId O GUID para o arquivo de dados de recuperação de origem a ser excluído.

DualEngineDoOnBeforeUnloadAndStop

Interrompe todas as navegações que estão em andamento e executa os onBeforeUnload manipuladores.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

Notifica que o DPI foi alterado e o layout da página deve ser recalculado.

public HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Habilita ou desabilita o modo de navegação com cursor.

público HRESULT DualEngineEnableCaretMode(BOOL fEnable)

Parâmetros
  • fEnable Especifica se a navegação com cursor deve ser habilitada.

DualEngineExecNavigationCommand

Executa um comando de navegação.

public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND comando)

Parâmetros
  • command O comando de navegação a ser executado.

DualEngineFindOnPage

Localiza uma instância de texto na página.

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

Parâmetros
  • iRequestID Uma ID para usar para correlacionar localizar em solicitações e eventos de página.

  • pszFindText O texto a ser localizado na página.

  • fFindNext Indica se a seleção deve se mover para a próxima ocorrência do texto de localização, verdadeiro avança a seleção e falso não.

  • fForward Indica a direção em que a seleção deve mim, verdadeiro se move para frente e falso se move para trás.

DualEngineForceClose

Forçar o fechamento da instância do navegador.

public HRESULT DualEngineForceClose()

DualEngineGeolocationPermissionResponse

Fornece uma resposta a uma solicitação de permissão de geolocalização.

público HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, resposta SITE_PERMISSION_RESPONSE)

Parâmetros
  • pszUri O URI de onde veio a solicitação de geolocalização.

  • response A resposta à solicitação.

DualEngineGoToEntry

Navega para uma entrada de registro de viagem específica.

público HRESULT DualEngineGoToEntry(ULONG ulEntryId)

Parâmetros
  • ulEntryId A ID da entrada do diário de viagem para navegar.

DualEngineInitialize

Inicializa o objeto do navegador com uma URL.

público HRESULT DualEngineInitialize(IDualEngine20BrowserObserver * pDualEngineObserver, DUALENGINECONFIGURATION config, EngineSwitchingPolicyFlags, engineSwitchingPolicyFlags, SentinelEntryInfo, sentinelEntryInfo , LPCWSTR, pszUrl, HWND, hwndHost, HWND * phwnd)

Parâmetros
  • pDualEngineObserver Um ponteiro para o observador deste navegador.

  • config Sinalizadores de configuração para o comportamento do navegador desejado.

  • engineSwitchingPolicyFlags Sinalizadores que determinam como a comutação do motor é tratada.

  • sentinelEntryInfo O número de itens de histórico antes e depois da navegação inicial para esta instância.

  • pszUrl A URL inicial para navegar.

  • hwndHost O HWND da janela do host para a qual a janela do navegador será parental.

  • phwnd O HWND da janela do navegador.

DualEngineInitialize2

Inicializa o objeto do navegador com uma URL; Esta versão permite que informações adicionais sobre a navegação inicial sejam passadas.

público HRESULT DualEngineInitialize2(IDualEngine20BrowserObserver * pDualEngineObserver, DUALENGINECONFIGURATION config, EngineSwitchingPolicyFlags engineSwitchingPolicyFlags, SentinelEntryInfo sentinelEntryInfo, LPCWSTR pszUrl, HWND hwndHost, HWND * phwnd, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parâmetros
  • pDualEngineObserver Um ponteiro para o observador deste navegador.

  • config Sinalizadores de configuração para o comportamento do navegador desejado.

  • engineSwitchingPolicyFlags Sinalizadores que determinam como a comutação do motor é tratada.

  • sentinelEntryInfo O número de itens de histórico antes e depois da navegação inicial para esta instância.

  • pszUrl A URL inicial para navegar.

  • hwndHost O HWND da janela do host para a qual a janela do navegador será parental.

  • phwnd O HWND da janela do navegador.

  • pszReferrer O cabeçalho de solicitação HTTP Referer para a navegação inicial.

  • pszHeaders Cabeçalhos adicionais a serem enviados ao servidor para a navegação inicial.

  • postData Dados a serem enviados ao servidor como parte de uma transação HTTP POST para a navegação inicial.

DualEngineInitializeWithRecoveryData

Inicializa o objeto do navegador usando dados de recuperação de tabulação.

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

Parâmetros
  • guidTabId O GUID do arquivo de dados de recuperação de origem para inicializar esta instância.

  • ulEntryId A ID da entrada no diário de viagem para navegar após a recuperação.

  • pDualEngineObserver Um ponteiro para o observador deste navegador.

  • config Sinalizadores de configuração para o comportamento do navegador desejado.

  • engineSwitchingPolicyFlags Sinalizadores que determinam como a comutação do motor é tratada.

  • sentinelEntryInfo O número de itens de histórico antes e depois da navegação inicial para esta instância.

  • pszUrl A URL inicial para navegar.

  • hwndHost O HWND da janela do host para a qual a janela do navegador será parental.

  • phwnd O HWND da janela do navegador.

DualEngineLostFocus

Notifica o navegador de que ele perdeu o foco.

público HRESULT DualEngineLostFocus(HWND hwndLostFocus)

Parâmetros
  • hwndLostFocus A janela para a qual o foco está se movendo.

DualEngineNavigate

Navega até uma URL.

público HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Parâmetros
  • pszUrl A URL para a qual navegar.

  • fSkipOnBeforeUnload Se deve ignorar o onBeforeUnload manuseio.

DualEngineNavigate2

Navega até uma URL, com informações adicionais sobre a navegação.

público HRESULT DualEngineNavigate2(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parâmetros
  • pszUrl A URL para a qual navegar.

  • fSkipOnBeforeUnload Se deve ignorar o onBeforeUnload manuseio.

  • pszReferrer O cabeçalho de solicitação HTTP Referer para esta navegação.

  • pszHeaders Cabeçalhos adicionais a serem enviados ao servidor para essa navegação.

  • postData Dados a serem enviados ao servidor como parte de uma transação HTTP POST para essa navegação.

DualEngineNotifyNavigationEntriesDeleted

Notifica que as entradas de navegação foram excluídas.

público HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo, sentinelEntryInfo )

Parâmetros
  • fShouldDeleteEntries Indica se o navegador deve excluir todas as entradas em sua lista.

  • sentinelEntryInfo O número de itens de histórico antes e depois da navegação inicial para esta instância.

DualEnginePrepareToExitRegion

Notifica o navegador de que uma navegação está ocorrendo em uma página que será manipulada pelo host.

público HRESULT DualEnginePrepareToExitRegion(tipo EXIT_REGION_TYPE)

Parâmetros
  • type O tipo de navegação que está causando essa saída.

DualEnginePrint

Invoca a caixa de diálogo Imprimir da página atual.

public HRESULT DualEnginePrint()

DualEngineProtectFocus

Controla se o navegador tenta alterar o foco para si mesmo.

público HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

Parâmetros
  • fProtectFocus Se true, o navegador não tentará roubar o foco; se false, roubar o foco é permitido.

DualEngineSavePageAs

Invoca a caixa de diálogo Salvar página da Web para a página atual.

public HRESULT DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Define sinalizadores que determinam como o navegador lida com a alternância de mecanismo.

público HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

Parâmetros
  • engineSwitchingPolicyFlags Sinalizadores que representam o comportamento desejado de comutação do mecanismo.

DualEngineSetFocus

Define o foco dentro do navegador hospedado.

público HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

Parâmetros
  • focusDirection A direção em que o foco está se movendo dentro do navegador.

DualEngineSetMediaFullscreen

Altera o estado de tela inteira da mídia reproduzida no navegador.

público HRESULT DualEngineSetMediaFullscreen(BOOL fFullscreen)

Aviso

Apesar do nome, essa função só sai da tela inteira e não fará nada se nenhuma mídia estiver em tela cheia. Passar true para a função é sempre um no-op.

Parâmetros
  • fFullscreen Se false, a tela cheia será encerrada se a mídia estiver em tela cheia; se true, nada acontecerá.

DualEngineSetPosition

Define o tamanho e a posição da janela do navegador.

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

Parâmetros
  • x A nova posição do lado esquerdo da janela, nas coordenadas do cliente.

  • y A nova posição da parte superior da janela, nas coordenadas do cliente.

  • iWidth A nova largura da janela, em pixels.

  • iHeight A nova altura da janela, em pixels.

DualEngineSetTheaterTela inteira

Altera o estado do modo Teatro do navegador.

público HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

No modo teatro, a janela do navegador preenche toda a tela e exibe uma barra de ferramentas que possui um conjunto mínimo de botões de navegação. Uma barra de status também é fornecida no canto superior direito da tela. As barras do Explorer, como Histórico e Favoritos, são exibidas como um painel de ocultação automática na borda esquerda da tela no modo teatro.

Parâmetros
  • fFullscreen Se true não estiver no modo de teatro, o navegador entrará no modo de teatro; se false estiver no modo de teatro, o navegador sairá do modo de teatro.

DualEngineSetTheaterMargins

Ajusta a margem superior da janela do navegador quando ela está sendo exibida no modo de teatro.

público HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Parâmetros
  • fTheaterShowing Indica se o host está no modo teatro de operações.

  • yTheaterThreshold O tamanho em pixels da margem entre a parte superior da tela e a janela de navegador em tela cheia.

DualEngineSetVisible

Notifica o navegador sobre uma alteração de visibilidade.

público HRESULT DualEngineSetVisible(BROWSERVISIBILITY visibility)

Parâmetros
  • visibility O estado de visibilidade em que estamos entrando.

DualEngineSetWindowStyle

Altera o estilo da janela do navegador.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Parâmetros
  • wlStyle O valor de Estilo de Janela a ser definido.

  • wlExStyle O valor de Estilo do Windows Estendido a ser definido.

DualEngineSetZoom

Altera o valor de zoom do navegador.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Parâmetros
  • iZoomPercent A porcentagem de zoom para a qual o navegador deve ser definido.

DualEngineSimulateKeyInput

Envia uma entrada de chave simulada.

público: HRESULT: DualEngineSimulateKeyInput(DWORD, vKey, KEYACTION, keyAction)

Parâmetros
  • vKey O código-chave virtual a ser simulado.

  • keyAction A principal ação a ser simulada.

DualEngineSimulateMouseInput

Envia uma entrada de mouse simulada.

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

Parâmetros
  • x A coordenada x.

  • y A coordenada y.

  • mouseAction A ação do mouse para simular.

DualEngineStopFindOnPage

Interrompe a operação de localização.

público HRESULT DualEngineStopFindOnPage(BOOL fClean)

Parâmetros
  • fClean Se true, os resultados realçados e o resultado selecionado atual serão limpos; se false, o resultado selecionado atual permanecerá selecionado.

DualEngineTranslateAccelerator

Processa uma mensagem de acelerador.

público HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)

Parâmetros
  • lpMsg Ponteiro para uma estrutura MSG que especifica a mensagem a ser traduzida.