Compartilhar via

interface IDualEngine20Browser

  • Artigo

Importante

A API Do DualEngine faz parte de um recurso de acesso limitado (confira Classe LimitedAccessFeatures). Para obter mais informações ou solicitar um token de desbloqueio, entre em contato com Suporte da Microsoft.

interface IDualEngine20Browser
  : public IUnknown

Representa uma guia Explorer da Internet.

Resumo

Members Descrições
DualEngineBrowserCommitido 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çãos em andamento e executa os onBeforeUnload manipuladores.
DualEngineDPIChanged Notifica que a DPI foi alterada e o layout da página deve ser recalculado.
DualEngineEnableCaretMode Habilita ou desabilita o modo de navegação do Caret.
DualEngineExecNavigationCommand Executa um comando de navegação.
DualEngineFindOnPage Localiza uma instância de texto na página.
DualEngineForceClose Fecha à força a instância do navegador.
DualEngineGeolocationPermissionResponse Fornece uma resposta a uma solicitação de permissão de geolocalização.
DualEngineGoToEntry Navega até uma entrada de log de viagem específica.
DualEngineInitialize Inicializa o objeto do navegador com uma URL.
DualEngineInitialize2 Inicializa o objeto do navegador com uma URL; essa 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 guia.
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 para a 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 comutação do mecanismo.
DualEngineSetFocus Define o foco dentro do navegador hospedado.
DualEngineSetMediaFullscreen Altera o estado de tela inteira da mídia que está sendo reproduzida no navegador.
DualEngineSetPosition Define o tamanho e a posição da janela do navegador.
DualEngineSetTheaterFullscreen Altera o estado do modo Theater do navegador.
DualEngineSetTheaterMargins Ajusta a margem superior da janela do navegador quando ela está sendo exibida no modo de teatro.
DualEngineSetVisible Notifica o navegador de 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 simulada do mouse.
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

DualEngineBrowserCommitido

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

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Fecha a instância do navegador.

hresult público DualEngineClose()

DualEngineDeleteTabRecoveryData

Exclui dados de recuperação de guia.

PUBLIC 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çãos em andamento e executa os onBeforeUnload manipuladores.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

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

PUBLIC HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Habilita ou desabilita o modo de navegação do Caret.

public HRESULT DualEngineEnableCaretMode(BOOL fEnable)

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

DualEngineExecNavigationCommand

Executa um comando de navegação.

public HRESULT DualEngineExecNavigationCommand(comando NAVIGATION_COMMAND)

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 a localização correlacionada em solicitações de página e eventos.

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

  • fFindNext Indica se a seleção deve passar para a próxima instância do texto de localização, true avança a seleção e false não.

  • fForward Indica a direção que a seleção deve me, verdadeiro se move para frente e falsos se movem para trás.

DualEngineForceClose

Fecha à força a instância do navegador.

HRESULT público DualEngineForceClose()

DualEngineGeolocationPermissionResponse

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

public HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, SITE_PERMISSION_RESPONSE response)

Parâmetros

  • pszUri O URI da qual a solicitação de geolocalização era.

  • response A resposta à solicitação.

DualEngineGoToEntry

Navega até uma entrada de log de viagem específica.

hresult público DualEngineGoToEntry(ULONG ulEntryId)

Parâmetros
  • ulEntryId A ID de entrada do log de viagem para navegar.

DualEngineInitialize

Inicializa o objeto do navegador com uma URL.

public 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 desejado do navegador.

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

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

  • pszUrl A URL inicial para a qual navegar.

  • hwndHost O HWND da janela do host à qual a janela do navegador será pai.

  • phwnd O HWND da janela do navegador.

DualEngineInitialize2

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

public HRESULT DualEngineInitialize2(IDualEngine20BrowserObserver * pDualEngineObserver, Configuração DUALENGINECONFIGURATION, 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 desejado do navegador.

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

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

  • pszUrl A URL inicial para a qual navegar.

  • hwndHost O HWND da janela do host à qual a janela do navegador será pai.

  • phwnd O HWND da janela do navegador.

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

  • pszHeaders Cabeçalhos adicionais para enviar 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 guia.

public 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 para o arquivo de dados de recuperação de origem com o qual inicializar essa instância.

  • ulEntryId A ID da entrada no log de viagens para navegar após a recuperação.

  • pDualEngineObserver Um ponteiro para o observador deste navegador.

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

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

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

  • pszUrl A URL inicial para a qual navegar.

  • hwndHost O HWND da janela do host à qual a janela do navegador será pai.

  • phwnd O HWND da janela do navegador.

DualEngineLostFocus

Notifica o navegador de que ele perdeu o foco.

hresult público DualEngineLostFocus(HWND hwndLostFocus)

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

DualEngineNavigate

Navega até uma URL.

public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Parâmetros

  • pszUrl A URL para a qual navegar.

  • fSkipOnBeforeUnload Se é necessário ignorar o onBeforeUnload tratamento.

DualEngineNavigate2

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

public HRESULT DualEngineNavigate2(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parâmetros

  • pszUrl A URL para a qual navegar.

  • fSkipOnBeforeUnload Se é necessário ignorar o onBeforeUnload tratamento.

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

  • pszHeaders Cabeçalhos adicionais para enviar 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.

public HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo sentinelEntryInfo)

Parâmetros

  • fShouldDeleteEntries Indica se o navegador deve excluir todas as entradas da lista.

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

DualEnginePrepareToExitRegion

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

hresult público DualEnginePrepareToExitRegion(EXIT_REGION_TYPE tipo)

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

DualEnginePrint

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

PUBLIC HRESULT DualEnginePrint()

DualEngineProtectFocus

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

public HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

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

DualEngineSavePageAs

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

HRESULT público DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Define sinalizadores que determinam como o navegador lida com a comutação do mecanismo.

public HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

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

DualEngineSetFocus

Define o foco dentro do navegador hospedado.

hresult público DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

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

DualEngineSetMediaFullscreen

Altera o estado de tela inteira da mídia que está sendo reproduzida no navegador.

hresult público 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 na tela inteira. Passar true para a função é sempre um não-op.

Parâmetros
  • fFullscreen Se false, a tela inteira será saída se a mídia estiver na tela inteira; 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.

DualEngineSetTheaterFullscreen

Altera o estado do modo Theater do navegador.

public HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

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

Parâmetros
  • fFullscreen Se true e não estiver no modo de teatro atualmente, o navegador entrará no modo de teatro; se false e atualmente 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.

public HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Parâmetros

  • fTheaterShowing Indica se o host está atualmente no modo de teatro.

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

DualEngineSetVisible

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

público HRESULT DualEngineSetVisible(VISIBILIDADE BROWSERVISIBILITY)

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

DualEngineSetWindowStyle

Altera o estilo da janela do navegador.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Parâmetros

  • wlStyle O valor estilo de janela a ser definido.

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

DualEngineSetZoom

Altera o valor de zoom do navegador.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Parâmetros
  • iZoomPercent O percentual de zoom para definir o navegador.

DualEngineSimulateKeyInput

Envia uma entrada de chave simulada.

public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)

Parâmetros

  • vKey O código de chave virtual a ser simulado.

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

DualEngineSimulateMouseInput

Envia uma entrada simulada do mouse.

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 a ser simulada.

DualEngineStopFindOnPage

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

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

hresult público DualEngineTranslateAccelerator(LPMSG lpMsg)

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