Compartilhar via


interface IDualEngine20Browser

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 Suporte da Microsoft.

interface IDualEngine20Browser
  : public IUnknown

Representa um separador internet Explorer.

Resumo

Members Descrições
DualEngineBrowserCommitted Notifica o browser de que foi consolidado e já não é especulativo.
DualEngineClose Fecha a instância do browser.
DualEngineDeleteTabRecoveryData Elimina dados de recuperação de separadores.
DualEngineDoOnBeforeUnloadAndStop Para quaisquer navegação que estejam em curso e executa os onBeforeUnload processadores.
DualEngineDPIChanged Notifica que o DPI foi alterado e que o esquema de página deve ser recalculado.
DualEngineEnableCaretMode Ativa ou desativa o modo de Navegação por Cursor.
DualEngineExecNavigationCommand Executa um comando de navegação.
DualEngineFindOnPage Localiza uma instância de texto na página.
DualEngineForceClose O force-closes da instância do browser.
DualEngineGeolocationPermissionResponse Fornece uma resposta a um pedido de permissão de geolocalização.
DualEngineGoToEntry Navega para uma entrada de registo de viagens específica.
DualEngineInitialize Inicializa o objeto do browser com um URL.
DualEngineInitialize2 Inicializa o objeto do browser com um URL; esta versão permite que sejam transmitidas informações adicionais sobre a navegação inicial.
DualEngineInitializeWithRecoveryData Inicializa o objeto do browser com dados de recuperação de separadores.
DualEngineLostFocus Notifica o browser de que perdeu o foco.
DualEngineNavigate Navega para um URL.
DualEngineNavigate2 Navega para um URL, com informações adicionais sobre a navegação.
DualEngineNotifyNavigationEntriesDeleted Notifica que as entradas de navegação foram eliminadas.
DualEnginePrepareToExitRegion Notifica o browser de que está a ocorrer uma navegação numa página que será processada pelo anfitrião.
DualEnginePrint Invoca a caixa de diálogo Imprimir da página atual.
DualEngineProtectFocus Controla se o browser tenta alterar o foco para si próprio.
DualEngineSavePageAs Invoca a caixa de diálogo Guardar página Web para a página atual.
DualEngineSetEngineSwitchingPolicyFlags Define sinalizadores que determinam a forma como o browser processa a mudança de motor.
DualEngineSetFocus Define o foco no browser alojado.
DualEngineSetMediaFullscreen Altera o estado de ecrã inteiro do suporte de dados que está a ser reproduzido no browser.
DualEngineSetPosition Define o tamanho e a posição da janela do browser.
DualEngineSetTheaterFullscreen Altera o estado do modo de Teatro do browser.
DualEngineSetTheaterMargins Ajusta a margem superior da janela do browser quando está a ser apresentada no modo de teatro.
DualEngineSetVisible Notifica o browser de uma alteração de visibilidade.
DualEngineSetWindowStyle Altera o estilo da janela do browser.
DualEngineSetZoom Altera o valor de zoom do browser.
DualEngineSimulateKeyInput Envia uma entrada de chave simulada.
DualEngineSimulateMouseInput Envia uma entrada de rato simulada.
DualEngineStopFindOnPage Para 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 browser de que foi consolidado e já não é especulativo.

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Fecha a instância do browser.

public HRESULT DualEngineClose()

DualEngineDeleteTabRecoveryData

Elimina dados de recuperação de separadores.

public HRESULT DualEngineDeleteTabRecoveryData(REFGUID guidTabId)

Parâmetros
  • guidTabId O GUID do ficheiro de dados de recuperação de origem a eliminar.

DualEngineDoOnBeforeUnloadAndStop

Para quaisquer navegação que estejam em curso e executa os onBeforeUnload processadores.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

Notifica que o DPI foi alterado e que o esquema de página deve ser recalculado.

public HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Ativa ou desativa o modo de Navegação por Cursor.

public HRESULT DualEngineEnableCaretMode(BOOL fEnable)

Parâmetros
  • fEnable Especifica se a navegação por cursor deve estar ativada.

DualEngineExecNavigationCommand

Executa um comando de navegação.

public HRESULT DualEngineExecNavigationCommand(comando NAVIGATION_COMMAND)

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

DualEngineFindOnPage

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

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

Parâmetros
  • iRequestID Um ID para utilizar correlaciona a procura em eventos e pedidos de página.

  • pszFindText O texto a localizar na página.

  • fFindNext Indica se a seleção deve mover para a instância seguinte o texto de localizar, verdadeiro avança a seleção e falso não.

  • fForward Indica a direção em que a seleção me deve fazer, verdadeiro avança e falso move-se para trás.

DualEngineForceClose

O force-closes da instância do browser.

public HRESULT DualEngineForceClose()

DualEngineGeolocationPermissionResponse

Fornece uma resposta a um pedido de permissão de geolocalização.

public HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, SITE_PERMISSION_RESPONSE resposta)

Parâmetros
  • pszUri O URI de onde provém o pedido de geolocalização.

  • response A resposta ao pedido.

DualEngineGoToEntry

Navega para uma entrada de registo de viagens específica.

public HRESULT DualEngineGoToEntry(ULONG ulEntryId)

Parâmetros
  • ulEntryId O ID de entrada do registo de viagens para onde navegar.

DualEngineInitialize

Inicializa o objeto do browser com um 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 para este browser.

  • config Sinalizadores de configuração para o comportamento pretendido do browser.

  • engineSwitchingPolicyFlags Sinalizadores que determinam a forma como a mudança de motor é processada.

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

  • pszUrl O URL inicial para onde navegar.

  • hwndHost O HWND da janela do anfitrião à qual a janela do browser será parentada.

  • phwnd O HWND da janela do browser.

DualEngineInitialize2

Inicializa o objeto do browser com um URL; esta versão permite que sejam transmitidas informações adicionais sobre a navegação inicial.

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 para este browser.

  • config Sinalizadores de configuração para o comportamento pretendido do browser.

  • engineSwitchingPolicyFlags Sinalizadores que determinam a forma como a mudança de motor é processada.

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

  • pszUrl O URL inicial para onde navegar.

  • hwndHost O HWND da janela do anfitrião à qual a janela do browser será parentada.

  • phwnd O HWND da janela do browser.

  • pszReferrer O cabeçalho do pedido do Referer HTTP para a navegação inicial.

  • pszHeaders Cabeçalhos adicionais a enviar para o servidor para a navegação inicial.

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

DualEngineInitializeWithRecoveryData

Inicializa o objeto do browser com dados de recuperação de separadores.

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 do ficheiro de dados de recuperação de origem para inicializar esta instância.

  • ulEntryId O ID da entrada no registo de viagens para onde navegar após a recuperação.

  • pDualEngineObserver Um ponteiro para o observador para este browser.

  • config Sinalizadores de configuração para o comportamento pretendido do browser.

  • engineSwitchingPolicyFlags Sinalizadores que determinam a forma como a mudança de motor é processada.

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

  • pszUrl O URL inicial para onde navegar.

  • hwndHost O HWND da janela do anfitrião à qual a janela do browser será parentada.

  • phwnd O HWND da janela do browser.

DualEngineLostFocus

Notifica o browser de que perdeu o foco.

public HRESULT DualEngineLostFocus(HWND hwndLostFocus)

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

DualEngineNavigate

Navega para um URL.

public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Parâmetros
  • pszUrl O URL para onde navegar.

  • fSkipOnBeforeUnload Se pretende ignorar o onBeforeUnload processamento.

DualEngineNavigate2

Navega para um 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 O URL para onde navegar.

  • fSkipOnBeforeUnload Se pretende ignorar o onBeforeUnload processamento.

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

  • pszHeaders Cabeçalhos adicionais a enviar para o servidor para esta navegação.

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

DualEngineNotifyNavigationEntriesDeleted

Notifica que as entradas de navegação foram eliminadas.

public HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo sentinelEntryInfo)

Parâmetros
  • fShouldDeleteEntries Indica se o browser deve eliminar todas as entradas na sua lista.

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

DualEnginePrepareToExitRegion

Notifica o browser de que está a ocorrer uma navegação numa página que será processada pelo anfitrião.

public HRESULT DualEnginePrepareToExitRegion(tipo de EXIT_REGION_TYPE)

Parâmetros
  • type O tipo de navegação que está a causar esta saída.

DualEnginePrint

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

public HRESULT DualEnginePrint()

DualEngineProtectFocus

Controla se o browser tenta alterar o foco para si próprio.

public HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

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

DualEngineSavePageAs

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

public HRESULT DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Define sinalizadores que determinam a forma como o browser processa a mudança de motor.

public HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

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

DualEngineSetFocus

Define o foco no browser alojado.

public HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

Parâmetros
  • focusDirection A direção em que o foco se move no browser.

DualEngineSetMediaFullscreen

Altera o estado de ecrã inteiro do suporte de dados que está a ser reproduzido no browser.

public HRESULT DualEngineSetMediaFullscreen(BOOL fFullscreen)

Aviso

Apesar do nome, esta função só sai do ecrã inteiro e não fará nada se nenhum suporte de dados estiver em ecrã inteiro. Passar true para a função é sempre uma operação sem operações.

Parâmetros
  • fFullscreen Se false, o ecrã inteiro será fechado se o suporte de dados estiver em ecrã inteiro; se true, nada acontecer.

DualEngineSetPosition

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

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 píxeis.

  • iHeight A nova altura da janela, em píxeis.

DualEngineSetTheaterFullscreen

Altera o estado do modo de Teatro do browser.

public HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

No modo de teatro, a janela de browsers preenche todo o ecrã e apresenta uma barra de ferramentas que tem um conjunto mínimo de botões de navegação. Também é fornecida uma barra de status no canto superior direito do ecrã. Explorer barras, como Histórico e Favoritos, são apresentadas como um painel de apresentação automática na margem esquerda do ecrã no modo de teatro.

Parâmetros
  • fFullscreen Se e não estiver atualmente no modo de teatro, o browser entrará no modo de teatro. Se truefalse e estiver atualmente no modo de teatro, o browser sairá do modo de teatro.

DualEngineSetTheaterMargins

Ajusta a margem superior da janela do browser quando está a ser apresentada no modo de teatro.

public HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Parâmetros
  • fTheaterShowing Indica se o anfitrião está atualmente no modo de teatro.

  • yTheaterThreshold O tamanho em píxeis da margem entre a parte superior do ecrã e a janela do browser de ecrã inteiro.

DualEngineSetVisible

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

public HRESULT DualEngineSetVisible(VISIBILIDADE BROWSERVISIBILITY)

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

DualEngineSetWindowStyle

Altera o estilo da janela do browser.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Parâmetros
  • wlStyle O valor Estilo da Janela a definir.

  • wlExStyle O valor Estilo expandido do Windows a definir.

DualEngineSetZoom

Altera o valor de zoom do browser.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Parâmetros
  • iZoomPercent A percentagem de zoom para definir o browser como.

DualEngineSimulateKeyInput

Envia uma entrada de chave simulada.

public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)

Parâmetros
  • vKey O código de chave virtual a simular.

  • keyAction A ação-chave a simular.

DualEngineSimulateMouseInput

Envia uma entrada de rato 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 rato a simular.

DualEngineStopFindOnPage

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

public 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.

public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)

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