Partager via


interface IDualEngine20Browser

Importante

L’API DualEngine fait partie d’une fonctionnalité d’accès limité (voir classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, contactez Support Microsoft.

interface IDualEngine20Browser
  : public IUnknown

Représente un onglet Explorer Internet.

Résumé

Members Descriptions
DualEngineBrowserCommitted Avertit le navigateur qu’il a été commité et qu’il n’est plus spéculatif.
DualEngineClose Ferme le instance du navigateur.
DualEngineDeleteTabRecoveryData Supprime les données de récupération d’onglet.
DualEngineDoOnBeforeUnloadAndStop Arrête toutes les navigations en cours et exécute les onBeforeUnload gestionnaires.
DualEngineDPIChanged Avertit que la résolution a changé et que la mise en page doit être recalculée.
DualEngineEnableCaretMode Active ou désactive le mode de navigation caret.
DualEngineExecNavigationCommand Exécute une commande de navigation.
DualEngineFindOnPage Recherche une instance de texte sur la page.
DualEngineForceClose Force la fermeture du navigateur instance.
DualEngineGeolocationPermissionResponse Fournit une réponse à une demande d’autorisation de géolocalisation.
DualEngineGoToEntry Accède à une entrée de journal de voyage spécifique.
DualEngineInitialize Initialise l’objet de navigateur avec une URL.
DualEngineInitialize2 Initialise l’objet de navigateur avec une URL ; cette version permet de transmettre des informations supplémentaires sur la navigation initiale.
DualEngineInitializeWithRecoveryData Initialise l’objet de navigateur à l’aide des données de récupération d’onglet.
DualEngineLostFocus Avertit le navigateur qu’il a perdu le focus.
DualEngineNavigate Accède à une URL.
DualEngineNavigate2 Accède à une URL, avec des informations supplémentaires sur la navigation.
DualEngineNotifyNavigationEntriesDeleted Avertit que les entrées de navigation ont été supprimées.
DualEnginePrepareToExitRegion Avertit le navigateur qu’une navigation se produit sur une page qui sera gérée par l’hôte.
DualEnginePrint Appelle la boîte de dialogue Imprimer pour la page active.
DualEngineProtectFocus Contrôle si le navigateur tente de modifier le focus sur lui-même.
DualEngineSavePageAs Appelle la boîte de dialogue Enregistrer la page web pour la page active.
DualEngineSetEngineSwitchingPolicyFlags Définit des indicateurs qui déterminent la façon dont le navigateur gère le changement de moteur.
DualEngineSetFocus Définit le focus dans le navigateur hébergé.
DualEngineSetMediaFullscreen Modifie l’état plein écran du média en lecture dans le navigateur.
DualEngineSetPosition Définit la taille et la position de la fenêtre du navigateur.
DualEngineSetTheaterFullscreen Modifie l’état du mode Théâtre du navigateur.
DualEngineSetTheaterMargins Ajuste la marge supérieure de la fenêtre du navigateur lorsqu’elle est affichée en mode théâtre.
DualEngineSetVisible Avertit le navigateur d’une modification de la visibilité.
DualEngineSetWindowStyle Modifie le style de la fenêtre du navigateur.
DualEngineSetZoom Modifie la valeur de zoom du navigateur.
DualEngineSimulateKeyInput Envoie une entrée de clé simulée.
DualEngineSimulateMouseInput Envoie une entrée de souris simulée.
DualEngineStopFindOnPage Arrête l’opération de recherche.
DualEngineTranslateAccelerator Traite un message d’accélérateur.

S’applique à

Product Introduit
Windows 10, version 20H1 KB5032278
Windows 11, version 22H2 KB5032288

Members

DualEngineBrowserCommitted

Avertit le navigateur qu’il a été commité et qu’il n’est plus spéculatif.

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Ferme le instance du navigateur.

public HRESULT DualEngineClose()

DualEngineDeleteTabRecoveryData

Supprime les données de récupération d’onglet.

public HRESULT DualEngineDeleteTabRecoveryData(REFGUID guidTabId)

Paramètres
  • guidTabId GUID du fichier de données de récupération source à supprimer.

DualEngineDoOnBeforeUnloadAndStop

Arrête toutes les navigations en cours et exécute les onBeforeUnload gestionnaires.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

Avertit que la résolution a changé et que la mise en page doit être recalculée.

public HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Active ou désactive le mode de navigation caret.

public HRESULT DualEngineEnableCaretMode(BOOL fEnable)

Paramètres
  • fEnable Spécifie si la navigation d’insertion doit être activée.

DualEngineExecNavigationCommand

Exécute une commande de navigation.

public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND command)

Paramètres
  • command Commande de navigation à exécuter.

DualEngineFindOnPage

Recherche une instance de texte sur la page.

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

Paramètres
  • iRequestID ID à utiliser pour mettre en corrélation la recherche sur les demandes et les événements de page.

  • pszFindText Texte à rechercher sur la page.

  • fFindNextIndique si la sélection doit passer à l’instance suivant le texte de recherche, true avance la sélection et false ne le fait pas.

  • fForward Indique la direction dans laquelle la sélection doit me faire, true se déplace vers l’avant et false se déplace vers l’arrière.

DualEngineForceClose

Force la fermeture du navigateur instance.

public HRESULT DualEngineForceClose()

DualEngineGeolocationPermissionResponse

Fournit une réponse à une demande d’autorisation de géolocalisation.

public HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, SITE_PERMISSION_RESPONSE response)

Paramètres
  • pszUri URI à partir duquel provient la demande de géolocalisation.

  • response Réponse à la demande.

DualEngineGoToEntry

Accède à une entrée de journal de voyage spécifique.

public HRESULT DualEngineGoToEntry(ULONG ulEntryId)

Paramètres
  • ulEntryId ID d’entrée du journal de voyage vers lequel accéder.

DualEngineInitialize

Initialise l’objet de navigateur avec une URL.

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

Paramètres
  • pDualEngineObserver Pointeur vers l’observateur pour ce navigateur.

  • config Indicateurs de configuration pour le comportement de navigateur souhaité.

  • engineSwitchingPolicyFlags Indicateurs qui déterminent la façon dont le changement de moteur est géré.

  • sentinelEntryInfoNombre d’éléments d’historique avant et après la navigation initiale pour cette instance.

  • pszUrl URL initiale à laquelle accéder.

  • hwndHost HWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.

  • phwnd HWND de la fenêtre du navigateur.

DualEngineInitialize2

Initialise l’objet de navigateur avec une URL ; cette version permet de transmettre des informations supplémentaires sur la navigation initiale.

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

Paramètres
  • pDualEngineObserver Pointeur vers l’observateur pour ce navigateur.

  • config Indicateurs de configuration pour le comportement de navigateur souhaité.

  • engineSwitchingPolicyFlags Indicateurs qui déterminent la façon dont le changement de moteur est géré.

  • sentinelEntryInfoNombre d’éléments d’historique avant et après la navigation initiale pour cette instance.

  • pszUrl URL initiale à laquelle accéder.

  • hwndHost HWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.

  • phwnd HWND de la fenêtre du navigateur.

  • pszReferrer En-tête de requête du refereur HTTP pour la navigation initiale.

  • pszHeaders En-têtes supplémentaires à envoyer au serveur pour la navigation initiale.

  • postData Données à envoyer au serveur dans le cadre d’une transaction HTTP POST pour la navigation initiale.

DualEngineInitializeWithRecoveryData

Initialise l’objet de navigateur à l’aide des données de récupération d’onglet.

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

Paramètres
  • guidTabIdGUID du fichier de données de récupération source avec lequel initialiser cette instance.

  • ulEntryId ID de l’entrée dans le journal de voyage vers lequel accéder après la récupération.

  • pDualEngineObserver Pointeur vers l’observateur pour ce navigateur.

  • config Indicateurs de configuration pour le comportement de navigateur souhaité.

  • engineSwitchingPolicyFlags Indicateurs qui déterminent la façon dont le changement de moteur est géré.

  • sentinelEntryInfoNombre d’éléments d’historique avant et après la navigation initiale pour cette instance.

  • pszUrl URL initiale à laquelle accéder.

  • hwndHost HWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.

  • phwnd HWND de la fenêtre du navigateur.

DualEngineLostFocus

Avertit le navigateur qu’il a perdu le focus.

public HRESULT DualEngineLostFocus(HWND hwndLostFocus)

Paramètres
  • hwndLostFocus Fenêtre vers laquelle le focus se déplace.

DualEngineNavigate

Accède à une URL.

public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Paramètres
  • pszUrl URL à laquelle accéder.

  • fSkipOnBeforeUnload Indique s’il faut ignorer la onBeforeUnload gestion.

DualEngineNavigate2

Accède à une URL, avec des informations supplémentaires sur la navigation.

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

Paramètres
  • pszUrl URL à laquelle accéder.

  • fSkipOnBeforeUnload Indique s’il faut ignorer la onBeforeUnload gestion.

  • pszReferrer En-tête de requête du refereur HTTP pour cette navigation.

  • pszHeaders En-têtes supplémentaires à envoyer au serveur pour cette navigation.

  • postData Données à envoyer au serveur dans le cadre d’une transaction HTTP POST pour cette navigation.

DualEngineNotifyNavigationEntriesDeleted

Avertit que les entrées de navigation ont été supprimées.

public HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo sentinelEntryInfo)

Paramètres
  • fShouldDeleteEntries Indique si le navigateur doit supprimer toutes les entrées de sa liste.

  • sentinelEntryInfoNombre d’éléments d’historique avant et après la navigation initiale pour cette instance.

DualEnginePrepareToExitRegion

Avertit le navigateur qu’une navigation se produit sur une page qui sera gérée par l’hôte.

public HRESULT DualEnginePrepareToExitRegion(EXIT_REGION_TYPE type)

Paramètres
  • type Type de navigation à l’origine de cette sortie.

DualEnginePrint

Appelle la boîte de dialogue Imprimer pour la page active.

public HRESULT DualEnginePrint()

DualEngineProtectFocus

Contrôle si le navigateur tente de modifier le focus sur lui-même.

public HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

Paramètres
  • fProtectFocus Si truela valeur est , le navigateur n’essaie pas de voler le focus ; si false, le vol du focus est autorisé.

DualEngineSavePageAs

Appelle la boîte de dialogue Enregistrer la page web pour la page active.

public HRESULT DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Définit des indicateurs qui déterminent la façon dont le navigateur gère le changement de moteur.

public HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

Paramètres
  • engineSwitchingPolicyFlags Indicateurs représentant le comportement de basculement de moteur souhaité.

DualEngineSetFocus

Définit le focus dans le navigateur hébergé.

public HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

Paramètres
  • focusDirection Direction dans laquelle le focus se déplace dans le navigateur.

DualEngineSetMediaFullscreen

Modifie l’état plein écran du média en lecture dans le navigateur.

public HRESULT DualEngineSetMediaFullscreen(BOOL fFullscreen)

Avertissement

Malgré son nom, cette fonction se ferme uniquement en mode plein écran et ne fait rien si aucun média n’est plein écran. Le passage true à la fonction est toujours une opération non opérationnelle.

Paramètres
  • fFullscreen Si falsela valeur est , le mode plein écran est arrêté si le média est en plein écran ; si true, rien ne se produit.

DualEngineSetPosition

Définit la taille et la position de la fenêtre du navigateur.

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

Paramètres
  • x Nouvelle position du côté gauche de la fenêtre, dans les coordonnées du client.

  • y Nouvelle position du haut de la fenêtre, dans les coordonnées du client.

  • iWidth Nouvelle largeur de la fenêtre, en pixels.

  • iHeight Nouvelle hauteur de la fenêtre, en pixels.

DualEngineSetTheaterFullscreen

Modifie l’état du mode Théâtre du navigateur.

public HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

En mode théâtre, la fenêtre du navigateur remplit tout l’écran et affiche une barre d’outils qui a un ensemble minimal de boutons de navigation. Une barre status est également fournie dans le coin supérieur droit de l’écran. Explorer barres, telles que Historique et Favoris, sont affichées sous la forme d’un volet d’affichage automatique sur le bord gauche de l’écran en mode théâtre.

Paramètres
  • fFullscreen Si true et pas actuellement en mode théâtre, le navigateur passe en mode théâtre ; si false et actuellement en mode théâtre, le navigateur quitte le mode théâtre.

DualEngineSetTheaterMargins

Ajuste la marge supérieure de la fenêtre du navigateur lorsqu’elle est affichée en mode théâtre.

public HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Paramètres
  • fTheaterShowing Indique si l’hôte est actuellement en mode théâtre.

  • yTheaterThreshold Taille en pixels de la marge entre le haut de l’écran et la fenêtre du navigateur plein écran.

DualEngineSetVisible

Avertit le navigateur d’une modification de la visibilité.

public HRESULT DualEngineSetVisible(BROWSERVISIBILITY visibility)

Paramètres
  • visibility État de visibilité que nous entrons.

DualEngineSetWindowStyle

Modifie le style de la fenêtre du navigateur.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Paramètres
  • wlStyle Valeur style de fenêtre à définir.

  • wlExStyle Valeur de style Windows étendu à définir.

DualEngineSetZoom

Modifie la valeur de zoom du navigateur.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Paramètres
  • iZoomPercent Pourcentage de zoom sur lequel définir le navigateur.

DualEngineSimulateKeyInput

Envoie une entrée de clé simulée.

public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)

Paramètres
  • vKey Code clé virtuel à simuler.

  • keyAction Action clé à simuler.

DualEngineSimulateMouseInput

Envoie une entrée de souris simulée.

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

Paramètres
  • x Coordonnée x.

  • y Coordonnée y.

  • mouseAction Action de la souris à simuler.

DualEngineStopFindOnPage

Arrête l’opération de recherche.

public HRESULT DualEngineStopFindOnPage(BOOL fClean)

Paramètres
  • fClean Si truela valeur est , les résultats en surbrillance et le résultat sélectionné actuel sont effacés ; si false, le résultat sélectionné actuel reste sélectionné.

DualEngineTranslateAccelerator

Traite un message d’accélérateur.

public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)

Paramètres
  • lpMsg Pointeur vers une structure MSG qui spécifie le message à traduire.