Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
-
guidTabIdGUID 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
-
fEnableSpé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
-
commandCommande 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
iRequestIDID à utiliser pour mettre en corrélation la recherche sur les demandes et les événements de page.pszFindTextTexte à 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.fForwardIndique 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
pszUriURI à partir duquel provient la demande de géolocalisation.responseRéponse à la demande.
DualEngineGoToEntry
Accède à une entrée de journal de voyage spécifique.
public HRESULT DualEngineGoToEntry(ULONG ulEntryId)
Paramètres
-
ulEntryIdID 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
pDualEngineObserverPointeur vers l’observateur pour ce navigateur.configIndicateurs de configuration pour le comportement de navigateur souhaité.engineSwitchingPolicyFlagsIndicateurs 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.pszUrlURL initiale à laquelle accéder.hwndHostHWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.phwndHWND 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
pDualEngineObserverPointeur vers l’observateur pour ce navigateur.configIndicateurs de configuration pour le comportement de navigateur souhaité.engineSwitchingPolicyFlagsIndicateurs 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.pszUrlURL initiale à laquelle accéder.hwndHostHWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.phwndHWND de la fenêtre du navigateur.pszReferrerEn-tête de requête du refereur HTTP pour la navigation initiale.pszHeadersEn-têtes supplémentaires à envoyer au serveur pour la navigation initiale.postDataDonné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.ulEntryIdID de l’entrée dans le journal de voyage vers lequel accéder après la récupération.pDualEngineObserverPointeur vers l’observateur pour ce navigateur.configIndicateurs de configuration pour le comportement de navigateur souhaité.engineSwitchingPolicyFlagsIndicateurs 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.pszUrlURL initiale à laquelle accéder.hwndHostHWND de la fenêtre hôte à laquelle la fenêtre du navigateur sera parentée.phwndHWND de la fenêtre du navigateur.
DualEngineLostFocus
Avertit le navigateur qu’il a perdu le focus.
public HRESULT DualEngineLostFocus(HWND hwndLostFocus)
Paramètres
-
hwndLostFocusFenêtre vers laquelle le focus se déplace.
DualEngineNavigate
Accède à une URL.
public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)
Paramètres
pszUrlURL à laquelle accéder.fSkipOnBeforeUnloadIndique s’il faut ignorer laonBeforeUnloadgestion.
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
pszUrlURL à laquelle accéder.fSkipOnBeforeUnloadIndique s’il faut ignorer laonBeforeUnloadgestion.pszReferrerEn-tête de requête du refereur HTTP pour cette navigation.pszHeadersEn-têtes supplémentaires à envoyer au serveur pour cette navigation.postDataDonné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
fShouldDeleteEntriesIndique 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
-
typeType 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
-
fProtectFocusSitruela valeur est , le navigateur n’essaie pas de voler le focus ; sifalse, 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
-
engineSwitchingPolicyFlagsIndicateurs 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
-
focusDirectionDirection 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
-
fFullscreenSifalsela valeur est , le mode plein écran est arrêté si le média est en plein écran ; sitrue, 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
xNouvelle position du côté gauche de la fenêtre, dans les coordonnées du client.yNouvelle position du haut de la fenêtre, dans les coordonnées du client.iWidthNouvelle largeur de la fenêtre, en pixels.iHeightNouvelle 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
-
fFullscreenSitrueet pas actuellement en mode théâtre, le navigateur passe en mode théâtre ; sifalseet 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
fTheaterShowingIndique si l’hôte est actuellement en mode théâtre.yTheaterThresholdTaille 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
wlStyleValeur style de fenêtre à définir.wlExStyleValeur de style Windows étendu à définir.
DualEngineSetZoom
Modifie la valeur de zoom du navigateur.
public HRESULT DualEngineSetZoom(int iZoomPercent)
Paramètres
-
iZoomPercentPourcentage 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
vKeyCode clé virtuel à simuler.keyActionAction clé à simuler.
DualEngineSimulateMouseInput
Envoie une entrée de souris simulée.
public HRESULT DualEngineSimulateMouseInput(DWORD x, DWORD y, MOUSEACTION mouseAction)
Paramètres
xCoordonnée x.yCoordonnée y.mouseActionAction de la souris à simuler.
DualEngineStopFindOnPage
Arrête l’opération de recherche.
public HRESULT DualEngineStopFindOnPage(BOOL fClean)
Paramètres
-
fCleanSitruela valeur est , les résultats en surbrillance et le résultat sélectionné actuel sont effacés ; sifalse, le résultat sélectionné actuel reste sélectionné.
DualEngineTranslateAccelerator
Traite un message d’accélérateur.
public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)
Paramètres
-
lpMsgPointeur vers une structure MSG qui spécifie le message à traduire.