interfaz IDualEngine20Browser

Importante

La API DualEngine forma parte de una característica de acceso limitado (consulte La clase LimitedAccessFeatures). Para obtener más información o para solicitar un token de desbloqueo, póngase en contacto con Soporte técnico de Microsoft.

interface IDualEngine20Browser
  : public IUnknown

Representa una pestaña de Internet Explorer.

Resumen

Members	Descripciones
DualEngineBrowserCommitted	Notifica al explorador que se ha confirmado y que ya no es especulativo.
DualEngineClose	Cierra la instancia del explorador.
DualEngineDeleteTabRecoveryData	Elimina los datos de recuperación de pestañas.
DualEngineDoOnBeforeUnloadAndStop	Detiene cualquier navegación que esté en curso y ejecute los onBeforeUnload controladores.
DualEngineDPIChanged	Notifica que se ha cambiado el valor de PPP y se debe volver a calcular el diseño de página.
DualEngineEnableCaretMode	Habilita o deshabilita el modo de exploración de símbolo de intercalación.
DualEngineExecNavigationCommand	Ejecuta un comando de navegación.
DualEngineFindOnPage	Busca una instancia de texto en la página.
DualEngineForceClose	Fuerza el cierre de la instancia del explorador.
DualEngineGeolocationPermissionResponse	Proporciona una respuesta a una solicitud de permiso de geolocalización.
DualEngineGoToEntry	Navega a una entrada de registro de viaje específica.
DualEngineInitialize	Inicializa el objeto del explorador con una dirección URL.
DualEngineInitialize2	Inicializa el objeto del explorador con una dirección URL; esta versión permite pasar información adicional sobre la navegación inicial.
DualEngineInitializeWithRecoveryData	Inicializa el objeto del explorador mediante datos de recuperación de tabulación.
DualEngineLostFocus	Notifica al explorador que ha perdido el foco.
DualEngineNavigate	Navega a una dirección URL.
DualEngineNavigate2	Navega a una dirección URL, con información adicional sobre la navegación.
DualEngineNotifyNavigationEntriesDeleted	Notifica que se han eliminado las entradas de navegación.
DualEnginePrepareToExitRegion	Notifica al explorador que se está produciendo una navegación a una página que controlará el host.
DualEnginePrint	Invoca el cuadro de diálogo Imprimir de la página actual.
DualEngineProtectFocus	Controla si el explorador intenta cambiar el foco a sí mismo.
DualEngineSavePageAs	Invoca el cuadro de diálogo Guardar página web para la página actual.
DualEngineSetEngineSwitchingPolicyFlags	Establece marcas que determinan cómo controla el explorador el cambio de motor.
DualEngineSetFocus	Establece el foco dentro del explorador hospedado.
Pantalla DualEngineSetMediaFullscreen	Cambia el estado de pantalla completa de los elementos multimedia que se reproducen en el explorador.
DualEngineSetPosition	Establece el tamaño y la posición de la ventana del explorador.
DualEngineSetTheaterFullscreen	Cambia el estado del modo teatro del explorador.
DualEngineSetTheaterMargins	Ajusta el margen superior de la ventana del explorador cuando se muestra en modo de cine.
DualEngineSetVisible	Notifica al explorador un cambio de visibilidad.
DualEngineSetWindowStyle	Cambia el estilo de la ventana del explorador.
DualEngineSetZoom	Cambia el valor de zoom del explorador.
DualEngineSimulateKeyInput	Envía una entrada de clave simulada.
DualEngineSimulateMouseInput	Envía una entrada simulada del mouse.
DualEngineStopFindOnPage	Detiene la operación de búsqueda.
DualEngineTranslateAccelerator	Procesa un mensaje de acelerador.

Se aplica a

Producto	Agregado
Windows 10, versión 20H1	KB5032278
Windows 11, versión 22H2	KB5032288

Members

DualEngineBrowserCommitted

Notifica al explorador que se ha confirmado y que ya no es especulativo.

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Cierra la instancia del explorador.

public HRESULT DualEngineClose()

DualEngineDeleteTabRecoveryData

Elimina los datos de recuperación de pestañas.

public HRESULT DualEngineDeleteTabRecoveryData(REFGUID guidTabId)

Parameters

• guidTabId GUID del archivo de datos de recuperación de origen que se va a eliminar.

DualEngineDoOnBeforeUnloadAndStop

Detiene cualquier navegación que esté en curso y ejecute los onBeforeUnload controladores.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

Notifica que se ha cambiado el valor de PPP y se debe volver a calcular el diseño de página.

public HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Habilita o deshabilita el modo de exploración de símbolo de intercalación.

public HRESULT DualEngineEnableCaretMode(BOOL fEnable)

Parameters

• fEnable Especifica si se debe habilitar la exploración de símbolos de intercalación.

DualEngineExecNavigationCommand

Ejecuta un comando de navegación.

public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND comando)

Parameters

• command Comando de navegación que se va a ejecutar.

DualEngineFindOnPage

Busca una instancia de texto en la página.

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

Parameters

• iRequestID Un identificador para usar la búsqueda correlacionada en eventos y solicitudes de página.

• pszFindText Texto que se va a buscar en la página.

• fFindNext Indica si la selección debe moverse a la siguiente instancia del texto de búsqueda, true avanza la selección y false no.

• fForward Indica la dirección en la que debería realizar la selección, true se mueve hacia delante y false se mueve hacia atrás.

DualEngineForceClose

Fuerza el cierre de la instancia del explorador.

public HRESULT DualEngineForceClose()

DualEngineGeolocationPermissionResponse

Proporciona una respuesta a una solicitud de permiso de geolocalización.

public HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, SITE_PERMISSION_RESPONSE response)

Parameters

• pszUri Uri del que procede la solicitud de geolocalización.

• response Respuesta a la solicitud.

DualEngineGoToEntry

Navega a una entrada de registro de viaje específica.

public HRESULT DualEngineGoToEntry(ULONG ulEntryId)

Parameters

• ulEntryId Id. de entrada del registro de viaje al que se va a navegar.

DualEngineInitialize

Inicializa el objeto del explorador con una dirección URL.

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

Parameters

• pDualEngineObserver Puntero al observador de este explorador.

• config Marcas de configuración para el comportamiento deseado del explorador.

• engineSwitchingPolicyFlags Marcas que determinan cómo se controla el cambio de motor.

• sentinelEntryInfo Número de elementos de historial antes y después de la navegación inicial para esta instancia.

• pszUrl Dirección URL inicial a la que se va a navegar.

• hwndHost HWND de la ventana host a la que se asignará la ventana del explorador.

• phwnd HWND de la ventana del explorador.

DualEngineInitialize2

Inicializa el objeto del explorador con una dirección URL; esta versión permite pasar información adicional sobre la navegación inicial.

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

Parameters

• pDualEngineObserver Puntero al observador de este explorador.

• config Marcas de configuración para el comportamiento deseado del explorador.

• engineSwitchingPolicyFlags Marcas que determinan cómo se controla el cambio de motor.

• sentinelEntryInfo Número de elementos de historial antes y después de la navegación inicial para esta instancia.

• pszUrl Dirección URL inicial a la que se va a navegar.

• hwndHost HWND de la ventana host a la que se asignará la ventana del explorador.

• phwnd HWND de la ventana del explorador.

• pszReferrer Encabezado de solicitud http referer para la navegación inicial.

• pszHeaders Encabezados adicionales para enviar al servidor para la navegación inicial.

• postData Datos que se enviarán al servidor como parte de una transacción HTTP POST para la navegación inicial.

DualEngineInitializeWithRecoveryData

Inicializa el objeto del explorador mediante datos de recuperación de tabulación.

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

Parameters

• guidTabId GUID del archivo de datos de recuperación de origen con el que inicializar esta instancia.

• ulEntryId Identificador de la entrada en el registro de viajes al que se va a navegar después de la recuperación.

• pDualEngineObserver Puntero al observador de este explorador.

• config Marcas de configuración para el comportamiento deseado del explorador.

• engineSwitchingPolicyFlags Marcas que determinan cómo se controla el cambio de motor.

• sentinelEntryInfo Número de elementos de historial antes y después de la navegación inicial para esta instancia.

• pszUrl Dirección URL inicial a la que se va a navegar.

• hwndHost HWND de la ventana host a la que se asignará la ventana del explorador.

• phwnd HWND de la ventana del explorador.

DualEngineLostFocus

Notifica al explorador que ha perdido el foco.

public HRESULT DualEngineLostFocus(HWND hwndLostFocus)

Parameters

• hwndLostFocus Ventana a la que se mueve el foco.

DualEngineNavigate

Navega a una dirección URL.

public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Parameters

• pszUrl Dirección URL a la que se va a navegar.

• fSkipOnBeforeUnload Si se omite el onBeforeUnload control.

DualEngineNavigate2

Navega a una dirección URL, con información adicional sobre la navegación.

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

Parameters

• pszUrl Dirección URL a la que se va a navegar.

• fSkipOnBeforeUnload Si se omite el onBeforeUnload control.

• pszReferrer Encabezado de solicitud http referer para esta navegación.

• pszHeaders Encabezados adicionales que se enviarán al servidor para esta navegación.

• postData Datos que se enviarán al servidor como parte de una transacción HTTP POST para esta navegación.

DualEngineNotifyNavigationEntriesDeleted

Notifica que se han eliminado las entradas de navegación.

public HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo sentinelEntryInfo)

Parameters

• fShouldDeleteEntries Indica si el explorador debe eliminar todas las entradas de su lista.

• sentinelEntryInfo Número de elementos de historial antes y después de la navegación inicial para esta instancia.

DualEnginePrepareToExitRegion

Notifica al explorador que se está produciendo una navegación a una página que controlará el host.

public HRESULT DualEnginePrepareToExitRegion(tipo EXIT_REGION_TYPE)

Parameters

• type Tipo de navegación que provoca esta salida.

DualEnginePrint

Invoca el cuadro de diálogo Imprimir de la página actual.

public HRESULT DualEnginePrint()

DualEngineProtectFocus

Controla si el explorador intenta cambiar el foco a sí mismo.

public HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

Parameters

• fProtectFocus Si truees , el explorador no intentará robar el foco; si false, se permite robar el foco.

DualEngineSavePageAs

Invoca el cuadro de diálogo Guardar página web para la página actual.

public HRESULT DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Establece marcas que determinan cómo controla el explorador el cambio de motor.

public HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

Parameters

• engineSwitchingPolicyFlags Marcas que representan el comportamiento de cambio de motor deseado.

DualEngineSetFocus

Establece el foco dentro del explorador hospedado.

public HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

Parameters

• focusDirection Dirección en la que se mueve el foco dentro del explorador.

Pantalla DualEngineSetMediaFullscreen

Cambia el estado de pantalla completa de los elementos multimedia que se reproducen en el explorador.

public HRESULT DualEngineSetMediaFullscreen(BOOL fFullscreen)

Advertencia

A pesar de su nombre, esta función solo sale de pantalla completa y no hará nada si no hay ningún medio a pantalla completa. Pasar true a la función siempre es una operación no operativa.

Parameters

• fFullscreen Si falsees , se cerrará la pantalla completa si el medio está a pantalla completa; si truees , no ocurre nada.

DualEngineSetPosition

Establece el tamaño y la posición de la ventana del explorador.

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

Parameters

• x Nueva posición del lado izquierdo de la ventana, en coordenadas de cliente.

• y Nueva posición de la parte superior de la ventana, en coordenadas de cliente.

• iWidth Nuevo ancho de la ventana, en píxeles.

• iHeight Nuevo alto de la ventana, en píxeles.

DualEngineSetTheaterFullscreen

Cambia el estado del modo teatro del explorador.

public HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

En el modo de cine, la ventana de exploradores rellena toda la pantalla y muestra una barra de herramientas que tiene un conjunto mínimo de botones de navegación. También se proporciona una barra de estado en la esquina superior derecha de la pantalla. Las barras del explorador, como Historial y Favoritos, se muestran como un panel autohide en el borde izquierdo de la pantalla en modo de cine.

Parameters

• fFullscreen Si true y no está actualmente en modo de teatro, el explorador entrará en modo de teatro; si false y actualmente está en modo de teatro, el explorador saldrá del modo de teatro.

DualEngineSetTheaterMargins

Ajusta el margen superior de la ventana del explorador cuando se muestra en modo de cine.

public HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Parameters

• fTheaterShowing Indica si el host está actualmente en modo de teatro.

• yTheaterThreshold Tamaño en píxeles del margen entre la parte superior de la pantalla y la ventana del explorador a pantalla completa.

DualEngineSetVisible

Notifica al explorador un cambio de visibilidad.

public HRESULT DualEngineSetVisible(BROWSERVISIBILITY visibility)

Parameters

• visibility El estado de visibilidad que estamos escribiendo.

DualEngineSetWindowStyle

Cambia el estilo de la ventana del explorador.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Parameters

• wlStyle Valor de Estilo de ventana que se va a establecer.

• wlExStyle Valor de Estilo extendido de Windows que se va a establecer.

DualEngineSetZoom

Cambia el valor de zoom del explorador.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Parameters

• iZoomPercent Porcentaje de zoom en el que se va a establecer el explorador.

DualEngineSimulateKeyInput

Envía una entrada de clave simulada.

public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)

Parameters

• vKey Código de clave virtual que se va a simular.

• keyAction Acción clave que se va a simular.

DualEngineSimulateMouseInput

Envía una entrada simulada del mouse.

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

Parameters

• x Coordenada x.

• y Coordenada y.

• mouseAction Acción del mouse que se va a simular.

DualEngineStopFindOnPage

Detiene la operación de búsqueda.

public HRESULT DualEngineStopFindOnPage(BOOL fClean)

Parameters

• fClean Si truees , se borrarán los resultados resaltados y el resultado seleccionado actual; si falsees , el resultado seleccionado actual permanecerá seleccionado.

DualEngineTranslateAccelerator

Procesa un mensaje de acelerador.

public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)

Parameters

• lpMsg Puntero a una estructura MSG que especifica el mensaje que se va a traducir.