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 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
-
guidTabIdO 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
-
fEnableEspecifica se a navegação por cursor deve estar ativada.
DualEngineExecNavigationCommand
Executa um comando de navegação.
public HRESULT DualEngineExecNavigationCommand(comando NAVIGATION_COMMAND)
Parâmetros
-
commandO 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
iRequestIDUm ID para utilizar correlaciona a procura em eventos e pedidos de página.pszFindTextO texto a localizar na página.fFindNextIndica 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.fForwardIndica 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
pszUriO URI de onde provém o pedido de geolocalização.responseA resposta ao pedido.
DualEngineGoToEntry
Navega para uma entrada de registo de viagens específica.
public HRESULT DualEngineGoToEntry(ULONG ulEntryId)
Parâmetros
-
ulEntryIdO 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
pDualEngineObserverUm ponteiro para o observador para este browser.configSinalizadores de configuração para o comportamento pretendido do browser.engineSwitchingPolicyFlagsSinalizadores que determinam a forma como a mudança de motor é processada.sentinelEntryInfoO número de itens do histórico antes e depois da navegação inicial para esta instância.pszUrlO URL inicial para onde navegar.hwndHostO HWND da janela do anfitrião à qual a janela do browser será parentada.phwndO 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
pDualEngineObserverUm ponteiro para o observador para este browser.configSinalizadores de configuração para o comportamento pretendido do browser.engineSwitchingPolicyFlagsSinalizadores que determinam a forma como a mudança de motor é processada.sentinelEntryInfoO número de itens do histórico antes e depois da navegação inicial para esta instância.pszUrlO URL inicial para onde navegar.hwndHostO HWND da janela do anfitrião à qual a janela do browser será parentada.phwndO HWND da janela do browser.pszReferrerO cabeçalho do pedido do Referer HTTP para a navegação inicial.pszHeadersCabeçalhos adicionais a enviar para o servidor para a navegação inicial.postDataDados 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
guidTabIdO GUID do ficheiro de dados de recuperação de origem para inicializar esta instância.ulEntryIdO ID da entrada no registo de viagens para onde navegar após a recuperação.pDualEngineObserverUm ponteiro para o observador para este browser.configSinalizadores de configuração para o comportamento pretendido do browser.engineSwitchingPolicyFlagsSinalizadores que determinam a forma como a mudança de motor é processada.sentinelEntryInfoO número de itens do histórico antes e depois da navegação inicial para esta instância.pszUrlO URL inicial para onde navegar.hwndHostO HWND da janela do anfitrião à qual a janela do browser será parentada.phwndO HWND da janela do browser.
DualEngineLostFocus
Notifica o browser de que perdeu o foco.
public HRESULT DualEngineLostFocus(HWND hwndLostFocus)
Parâmetros
-
hwndLostFocusA janela para a qual o foco se está a mover.
DualEngineNavigate
Navega para um URL.
public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)
Parâmetros
pszUrlO URL para onde navegar.fSkipOnBeforeUnloadSe pretende ignorar oonBeforeUnloadprocessamento.
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
pszUrlO URL para onde navegar.fSkipOnBeforeUnloadSe pretende ignorar oonBeforeUnloadprocessamento.pszReferrerO cabeçalho de pedido do Referer HTTP para esta navegação.pszHeadersCabeçalhos adicionais a enviar para o servidor para esta navegação.postDataDados 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
fShouldDeleteEntriesIndica se o browser deve eliminar todas as entradas na sua lista.sentinelEntryInfoO 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
-
typeO 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
-
fProtectFocusSetrue, o browser não tentará roubar o foco; sefalse, 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
-
engineSwitchingPolicyFlagsSinalizadores 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
-
focusDirectionA 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
-
fFullscreenSefalse, o ecrã inteiro será fechado se o suporte de dados estiver em ecrã inteiro; setrue, 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
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 píxeis.iHeightA 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
-
fFullscreenSe e não estiver atualmente no modo de teatro, o browser entrará no modo de teatro. Setruefalsee 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
fTheaterShowingIndica se o anfitrião está atualmente no modo de teatro.yTheaterThresholdO 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
-
visibilityO estado de visibilidade que estamos a introduzir.
DualEngineSetWindowStyle
Altera o estilo da janela do browser.
public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)
Parâmetros
wlStyleO valor Estilo da Janela a definir.wlExStyleO valor Estilo expandido do Windows a definir.
DualEngineSetZoom
Altera o valor de zoom do browser.
public HRESULT DualEngineSetZoom(int iZoomPercent)
Parâmetros
-
iZoomPercentA percentagem de zoom para definir o browser como.
DualEngineSimulateKeyInput
Envia uma entrada de chave simulada.
public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)
Parâmetros
vKeyO código de chave virtual a simular.keyActionA ação-chave a simular.
DualEngineSimulateMouseInput
Envia uma entrada de rato simulada.
public HRESULT DualEngineSimulateMouseInput(DWORD x, DWORD y, MOUSEACTION mouseAction)
Parâmetros
xA coordenada x.yA coordenada y.mouseActionA ação do rato a simular.
DualEngineStopFindOnPage
Para a operação de localização.
public 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.
public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)
Parâmetros
-
lpMsgUm ponteiro para uma estrutura MSG que especifica a mensagem a traduzir.