Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
-
guidTabIdO 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
-
fEnableEspecifica se a navegação com cursor deve ser habilitada.
DualEngineExecNavigationCommand
Executa um comando de navegação.
public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND comando)
Parâmetros
-
commandO 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
iRequestIDUma ID para usar para correlacionar localizar em solicitações e eventos de página.pszFindTextO texto a ser localizado na página.fFindNextIndica 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.fForwardIndica 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
pszUriO URI de onde veio a solicitação de geolocalização.responseA resposta à solicitação.
DualEngineGoToEntry
Navega para uma entrada de registro de viagem específica.
público HRESULT DualEngineGoToEntry(ULONG ulEntryId)
Parâmetros
-
ulEntryIdA 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
pDualEngineObserverUm ponteiro para o observador deste navegador.configSinalizadores de configuração para o comportamento do navegador desejado.engineSwitchingPolicyFlagsSinalizadores que determinam como a comutação do motor é tratada.sentinelEntryInfoO número de itens de histórico antes e depois da navegação inicial para esta instância.pszUrlA URL inicial para navegar.hwndHostO HWND da janela do host para a qual a janela do navegador será parental.phwndO 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
pDualEngineObserverUm ponteiro para o observador deste navegador.configSinalizadores de configuração para o comportamento do navegador desejado.engineSwitchingPolicyFlagsSinalizadores que determinam como a comutação do motor é tratada.sentinelEntryInfoO número de itens de histórico antes e depois da navegação inicial para esta instância.pszUrlA URL inicial para navegar.hwndHostO HWND da janela do host para a qual a janela do navegador será parental.phwndO HWND da janela do navegador.pszReferrerO cabeçalho de solicitação HTTP Referer para a navegação inicial.pszHeadersCabeçalhos adicionais a serem enviados ao servidor para a navegação inicial.postDataDados 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
guidTabIdO GUID do arquivo de dados de recuperação de origem para inicializar esta instância.ulEntryIdA ID da entrada no diário de viagem para navegar após a recuperação.pDualEngineObserverUm ponteiro para o observador deste navegador.configSinalizadores de configuração para o comportamento do navegador desejado.engineSwitchingPolicyFlagsSinalizadores que determinam como a comutação do motor é tratada.sentinelEntryInfoO número de itens de histórico antes e depois da navegação inicial para esta instância.pszUrlA URL inicial para navegar.hwndHostO HWND da janela do host para a qual a janela do navegador será parental.phwndO HWND da janela do navegador.
DualEngineLostFocus
Notifica o navegador de que ele perdeu o foco.
público HRESULT DualEngineLostFocus(HWND hwndLostFocus)
Parâmetros
-
hwndLostFocusA janela para a qual o foco está se movendo.
DualEngineNavigate
Navega até uma URL.
público HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)
Parâmetros
pszUrlA URL para a qual navegar.fSkipOnBeforeUnloadSe deve ignorar oonBeforeUnloadmanuseio.
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
pszUrlA URL para a qual navegar.fSkipOnBeforeUnloadSe deve ignorar oonBeforeUnloadmanuseio.pszReferrerO cabeçalho de solicitação HTTP Referer para esta navegação.pszHeadersCabeçalhos adicionais a serem enviados ao servidor para essa navegação.postDataDados 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
fShouldDeleteEntriesIndica se o navegador deve excluir todas as entradas em sua lista.sentinelEntryInfoO 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
-
typeO 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
-
fProtectFocusSetrue, o navegador não tentará roubar o foco; sefalse, 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
-
engineSwitchingPolicyFlagsSinalizadores 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
-
focusDirectionA 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
-
fFullscreenSefalse, a tela cheia será encerrada se a mídia estiver em tela cheia; setrue, 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
xA nova posição do lado esquerdo da janela, nas coordenadas do cliente.yA nova posição da parte superior da janela, nas coordenadas do cliente.iWidthA nova largura da janela, em pixels.iHeightA 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
-
fFullscreenSetruenão estiver no modo de teatro, o navegador entrará no modo de teatro; sefalseestiver 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
fTheaterShowingIndica se o host está no modo teatro de operações.yTheaterThresholdO 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
-
visibilityO estado de visibilidade em que estamos entrando.
DualEngineSetWindowStyle
Altera o estilo da janela do navegador.
public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)
Parâmetros
wlStyleO valor de Estilo de Janela a ser definido.wlExStyleO valor de Estilo do Windows Estendido a ser definido.
DualEngineSetZoom
Altera o valor de zoom do navegador.
public HRESULT DualEngineSetZoom(int iZoomPercent)
Parâmetros
-
iZoomPercentA 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
vKeyO código-chave virtual a ser simulado.keyActionA principal ação a ser simulada.
DualEngineSimulateMouseInput
Envia uma entrada de mouse simulada.
public HRESULT DualEngineSimulateMouseInput(DWORD x, DWORD y, MOUSEACTION mouseAction)
Parâmetros
xA coordenada x.yA coordenada y.mouseActionA ação do mouse para simular.
DualEngineStopFindOnPage
Interrompe a operação de localização.
público HRESULT DualEngineStopFindOnPage(BOOL fClean)
Parâmetros
-
fCleanSetrue, os resultados realçados e o resultado selecionado atual serão limpos; sefalse, o resultado selecionado atual permanecerá selecionado.
DualEngineTranslateAccelerator
Processa uma mensagem de acelerador.
público HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)
Parâmetros
-
lpMsgPonteiro para uma estrutura MSG que especifica a mensagem a ser traduzida.