Partage via

interface IDualEngine20BrowserObserver

  • Article

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 le support Microsoft.

interface IDualEngine20BrowserObserver
  : public IUnknown

Reçoit des événements du navigateur.

Résumé

Members Descriptions
ContinueNavigationInEdge Déclenché lorsque le navigateur souhaite arrêter l’hébergement du contenu et que la navigation vers l’URL continue dans le processus d’hébergement.
ContinueNavigationInEdge2 Déclenché lorsque le navigateur souhaite arrêter l’hébergement du contenu et que la navigation vers l’URL se poursuive dans le processus d’hébergement ; cette version fournit des informations supplémentaires sur la navigation.
NavigateToOffsetInEdge Déclenché lorsque le navigateur demande à accéder à un décalage d’entrée de journal de voyage.
OnAllButCurrentEntryDeleted Déclenché lorsque le navigateur a supprimé toutes les entrées de son journal de voyage, à l’exception de l’entrée actuelle.
OnAsyncHungCheckReply Déclenché lorsque le navigateur traite un message de vérification de blocage asynchrone, consultez IDualEngine20BrowserSession ::SetHangDetectionMessages().
OnAttentionState Déclenché lors de la demande d’attention de l’utilisateur.
OnBeforeUnloadAndStopComplete Déclenché lorsque le traitement de l’événement beforeUnload est terminé.
OnCloseCompleted Déclenché lorsque le navigateur est fermé.
OnCloseRequested Déclenché lorsque le navigateur a demandé à se fermer.
OnDialogShown Déclenché lorsqu’un navigateur affiche ou masque une boîte de dialogue modale.
OnDocumentComplete Déclenché lorsqu’un document est complètement chargé et initialisé.
OnDocumentModeSet Déclenché lorsque le mode document a changé.
OnEnterpriseIDSet Déclenché lorsqu’une navigation a été terminée ; fournit des informations sur l’ID d’entreprise.
OnFindOnPageResult Déclenché lors de la modification des résultats de la recherche sur la page.
OnFinishedSetFocus Déclenché lorsqu’une requête IDualEngine20Browser ::D ualEngineSetFocus() a terminé le traitement.
OnGeolocationFeatureInUse Déclenché lors de l’accès aux données de géolocalisation.
OnGeolocationPermissionRequested Déclenché lorsque l’autorisation de l’utilisateur est nécessaire pour activer la géolocalisation.
OnHasBeforeUnloadChanged Déclenché lorsqu’un OnBeforeUnload gestionnaire a été inscrit ou supprimé.
OnIndicatorItemsSet Déclenché lorsqu’une navigation a été terminée ; fournit des informations d’état sur l’état actuel de la page du navigateur.
OnInputAttempted Déclenché lors de la réception d’une entrée utilisateur.
OnLoadingActivityChanged Déclenché lorsque l’état de chargement de la page change.
OnMixedContentBlocked Déclenché lorsque le contenu mixte a été bloqué.
OnNavigationComplete Déclenché lorsqu’une navigation a été terminée.
OnNavigationFailed Déclenché en cas d’échec de navigation.
OnNavigationToDownload Déclenché lorsqu’une navigation s’est terminée par un téléchargement.
OnNewWindow Déclenché lorsqu’une nouvelle fenêtre a été créée.
OnPopupBlocked Déclenché lorsqu’une fenêtre contextuelle a été bloquée.
OnPrepareToExitRegionFailed Déclenché lorsque le navigateur n’a pas réussi à gérer un appel IDualEngine20Browser ::D ualEnginePrepareToExitRegion().
OnReadyToExitRegion Déclenché lorsque le navigateur a correctement géré un appel IDualEngine20Browser ::D ualEnginePrepareToExitRegion().
OnTabCrashed Déclenché lorsque l’onglet s’est bloqué.
OnTabHangReported Déclenché lorsque le navigateur est bloqué.
OnUnexpectedRundown Déclenché lorsque le navigateur s’est fermé de manière inattendue.
OnUnhandledKeyboardAccelerator Déclenché lors du traitement d’un accélérateur clavier et il est déterminé que le navigateur ne gère pas ou ne doit pas se baser sur rgHostPriorityAccels.
OnUnhandledKeyboardAcceleratorAsync Déclenché lors du traitement d’un accélérateur clavier et il est déterminé que le navigateur ne gère pas ou ne doit pas se baser sur rgHostPriorityAccels.
OnVisibleComplete Déclenché lorsque le contenu de la page est rendu visible.
OnZoomChanged Déclenché lorsque le zoom a changé.
OpenURLInEdge Déclenché lorsque le navigateur demande à l’hôte d’accéder à une URL dans une nouvelle fenêtre.
OpenURLInEdge2 Déclenché lorsque le navigateur demande à l’hôte d’accéder à une URL dans une nouvelle fenêtre ; cette version fournit des informations supplémentaires sur la navigation.
RequestHostAddFavorite Déclenché lorsqu’une page a été demandée pour être ajoutée aux favoris.
RequestHostCreateUrlTip Déclenché lors de la demande d’affichage d’une info-bulle contenant une URL.
RequestHostFocus Déclenché lorsque le focus est demandé pour passer à la fenêtre hôte.
RequestHostFullscreen Déclenché lorsque la page demande que l’hôte affiche le contenu en plein écran.
RequestHostHideUrlTip Déclenché lors de la demande de masquer une info-bulle contenant une URL.
RequestHostPositionChanged Déclenché lorsque le navigateur demande que l’hôte change sa taille ou sa position.
RequestHostShowTheater Déclenché lorsque le navigateur demande à l’hôte d’entrer ou de quitter le mode théâtre.
RequestHostWindowFocus Déclenché lorsque l’hôte est invité à prendre ou à abandonner le focus.
RequestHostWindowFocusSync Déclenché lorsque l’hôte est invité à prendre ou à abandonner le focus.
UpdateHostFavicon Déclenché lorsque le favicon a changé.
UpdateHostTitle Déclenché lorsque le titre de la page a été mis à jour.
UpdateSecureLockIcon Déclenché lorsque les informations de sécurité de la page ont changé.

S’applique à

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

Members

ContinueNavigationInEdge

Déclenché lorsque le navigateur souhaite arrêter l’hébergement du contenu et que la navigation vers l’URL continue dans le processus d’hébergement.

public HRESULT ContinueNavigationInEdge(LPCWSTR pszUrl, ULONG ulCookieSyncVersion)

Paramètres

  • pszUrl URL vers laquelle vous devez naviguer.

  • ulCookieSyncVersion Nombre qui peut être utilisé pour mettre en corrélation une navigation avec un état de cookie spécifique.

ContinueNavigationInEdge2

Déclenché lorsque le navigateur souhaite arrêter l’hébergement du contenu et que la navigation vers l’URL se poursuive dans le processus d’hébergement ; cette version fournit des informations supplémentaires sur la navigation.

public HRESULT ContinueNavigationInEdge2(LPCWSTR pszUrl, ULONG ulCookieSyncVersion, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Paramètres

  • pszUrl URL vers laquelle vous devez naviguer.

  • ulCookieSyncVersion Nombre qui peut être utilisé pour mettre en corrélation une navigation avec un état de cookie spécifique.

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

  • pszHeaders En-têtes HTTP supplémentaires.

  • postData Données HTTP POST, telles que les données de formulaire.

Déclenché lorsque le navigateur demande à accéder à un décalage d’entrée de journal de voyage.

public HRESULT NavigateToOffsetInEdge(int iOffset)

Paramètres
  • iOffset Décalage vers lequel accéder.

OnAllButCurrentEntryDeleted

Déclenché lorsque le navigateur a supprimé toutes les entrées de son journal de voyage, à l’exception de l’entrée actuelle.

public HRESULT OnAllButCurrentEntryDeleted(VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Paramètres

  • pVisibleListEntries Liste contenant les nouvelles entrées du journal de voyage depuis la dernière mise à jour. Dans ce cas, il n’aura que l’entrée active actuelle.

  • cVisibleListEntries Nombre d’éléments dans pVisibleListEntries

OnAsyncHungCheckReply

Déclenché lorsque le navigateur traite un message de vérification de blocage asynchrone, consultez IDualEngine20BrowserSession ::SetHangDetectionMessages().

public HRESULT OnAsyncHungCheckReply(ULONG correlationId)

Paramètres
  • correlationId ID pour mettre en corrélation la réponse avec le message envoyé.

OnAttentionState

Déclenché lors de la demande d’attention de l’utilisateur.

public HRESULT OnAttentionState(ATTENTIONSTATE attentionState)

Paramètres
  • attentionState Raison pour laquelle l’attention de l’utilisateur est demandée.

OnBeforeUnloadAndStopComplete

Déclenché lorsque le traitement de l’événement beforeUnload est terminé.

public HRESULT OnBeforeUnloadAndStopComplete(BOOL agreeToClose)

Paramètres
  • agreeToClose Indique si l’utilisateur a accepté de quitter la page.

OnCloseCompleted

Déclenché lorsque le navigateur est fermé.

public HRESULT OnCloseCompleted()

OnCloseRequested

Déclenché lorsque le navigateur a demandé à se fermer.

public HRESULT OnCloseRequested()

OnDialogShown

Déclenché lorsqu’un navigateur affiche ou masque une boîte de dialogue modale.

public HRESULT OnDialogShown(BOOL fShown)

Paramètres
  • fShown Indique si la boîte de dialogue a été affichée ou masquée.

OnDocumentComplete

Déclenché lorsqu’un document est complètement chargé et initialisé.

public HRESULT OnDocumentComplete(ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Paramètres

  • ulCurrentEntryId ID d’entrée du journal de voyage pour la page qui a déclenché cet événement.

  • pVisibleListEntries Liste contenant les nouvelles entrées du journal de voyage depuis la dernière mise à jour.

  • cVisibleListEntries Nombre d’éléments dans pVisibleListEntries

OnDocumentModeSet

Déclenché lorsque le mode document a changé.

public HRESULT OnDocumentModeSet(ULONG documentMode)

Paramètres
  • documentMode Nouvelle version du mode document.

OnEnterpriseIDSet

Déclenché lorsqu’une navigation a été terminée ; fournit des informations sur l’ID d’entreprise.

public HRESULT OnEnterpriseIDSet(BOOL fEnterpriseID)

Paramètres
  • fEnterpriseID Indique si un ID d’entreprise est défini dans le navigateur.

OnFindOnPageResult

Déclenché lors de la modification des résultats de la recherche sur la page.

public HRESULT OnFindOnPageResult(int iRequestID, int cMatches, int iActiveMatch)

Paramètres

OnFinishedSetFocus

Déclenché lorsqu’une requête IDualEngine20Browser ::D ualEngineSetFocus() a terminé le traitement.

public HRESULT OnFinishedSetFocus()

OnGeolocationFeatureInUse

Déclenché lors de l’accès aux données de géolocalisation.

public HRESULT OnGeolocationFeatureInUse(LPCWSTR pszContextUrl, SITE_PERMISSION_FEATURE_MODE featureMode)

Paramètres

  • pszContextUrl URL de la page qui accède aux données de géolocalisation.

  • featureMode Indique si l’accès a été bloqué ou autorisé.

OnGeolocationPermissionRequested

Déclenché lorsque l’autorisation de l’utilisateur est nécessaire pour activer la géolocalisation.

public HRESULT OnGeolocationPermissionRequested(LPCWSTR pszContextUrl)

Paramètres
  • pszContextUrl URL de la page demandant l’autorisation de géolocalisation.

OnHasBeforeUnloadChanged

Déclenché lorsqu’un OnBeforeUnload gestionnaire a été inscrit ou supprimé.

public HRESULT OnHasBeforeUnloadChanged(BOOL fBeforeUnload)

Paramètres
  • fBeforeUnload true indique qu’un OnBeforeUnload gestionnaire a été inscrit ; false indique qu’il a été supprimé.

OnIndicatorItemsSet

Déclenché lorsqu’une navigation a été terminée ; fournit des informations d’état sur l’état actuel de la page du navigateur.

public HRESULT OnIndicatorItemsSet(BOOL fProtectedMode, BOOL fEnhancedProtectedMode, DWORD dwUrlZone, BOOL fEnterpriseMode)

Paramètres

  • fProtectedMode Indique si le navigateur est en mode protégé.

  • fEnhancedProtectedMode Indique si le navigateur est en mode protégé amélioré.

  • dwUrlZone Zone de l’URL actuelle.

  • fEnterpriseMode Indique si le navigateur est en mode Entreprise.

OnInputAttempted

Déclenché lors de la réception d’une entrée utilisateur.

public HRESULT OnInputAttempted()

OnLoadingActivityChanged

Déclenché lorsque l’état de chargement de la page change.

public HRESULT OnLoadingActivityChanged(BOOL fLoading)

Paramètres
  • fLoading Indique si la page est en cours de chargement ou non.

OnMixedContentBlocked

Déclenché lorsque le contenu mixte a été bloqué.

public HRESULT OnMixedContentBlocked()

OnNavigationComplete

Déclenché lorsqu’une navigation a été terminée.

public HRESULT OnNavigationComplete(REFGUID guidTabId, ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries, DWORD dwNavFlags, SECURELOCKICON secureLockIcon, DWORD dwSecurityFlags, CryptDataBlob * pDualEngineCertificates, int cCertificateChainBlobs)

Paramètres

  • guidTabId GUID de récupération de l’onglet.

  • ulCurrentEntryId ID représentant cette navigation dans la liste des entrées visibles.

  • pVisibleListEntries Liste contenant les nouvelles entrées du journal de voyage depuis la dernière mise à jour.

  • cVisibleListEntries Nombre d’éléments dans pVisibleListEntries.

  • dwNavFlags Indicateurs indiquant le type de navigation qui s’est produit.

  • secureLockIcon État de sécurité de la page.

  • dwSecurityFlags Indicateurs indiquant des erreurs de certificat pour la page.

  • pDualEngineCertificates Liste contenant la chaîne de certificats pour la page de l’entrée actuelle.

  • cCertificateChainBlobs Nombre d’éléments dans pDualEngineCertificates.

OnNavigationFailed

Déclenché en cas d’échec de navigation.

public HRESULT OnNavigationFailed(NAVIGATIONFAILEDREASON failureReason)

Paramètres
  • failureReason Raison de l’échec de la navigation.

OnNavigationToDownload

Déclenché lorsqu’une navigation s’est terminée par un téléchargement.

public HRESULT OnNavigationToDownload()

OnNewWindow

Déclenché lorsqu’une nouvelle fenêtre a été créée.

public HRESULT OnNewWindow(IDualEngine20Browser * pNewBrowser, HWND hwnd, const DualEngineNewWindowOptions * options, IDualEngine20BrowserObserver ** ppObserver)

Paramètres

  • pNewBrowser Objet de navigateur pour la nouvelle fenêtre.

  • hwnd Handle de la nouvelle fenêtre.

  • options Options avec laquelle la nouvelle fenêtre a été créée.

  • ppObserver Objet observateur de la nouvelle fenêtre.

OnPopupBlocked

Déclenché lorsqu’une fenêtre contextuelle a été bloquée.

public HRESULT OnPopupBlocked(LPCWSTR pszContextUrl, LPCWSTR pszPopupUrl)

Paramètres

  • pszContextUrl URL de la page qui a émis la commande pour ouvrir la fenêtre contextuelle.

  • pszPopupUrl URL de la page contextuelle.

OnPrepareToExitRegionFailed

Déclenché lorsque le navigateur n’a pas réussi à gérer un appel IDualEngine20Browser ::D ualEnginePrepareToExitRegion().

public HRESULT OnPrepareToExitRegionFailed()

OnReadyToExitRegion

Déclenché lorsque le navigateur a correctement géré un appel IDualEngine20Browser ::D ualEnginePrepareToExitRegion().

public HRESULT OnReadyToExitRegion(REFGUID guidClonedTabId, ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntriesComplete, int cVisibleListEntriesComplete)

Paramètres

  • guidClonedTabId GUID du fichier de données de récupération d’onglet qui sauvegarde la région quittée.

  • ulCurrentEntryId ID d’entrée du journal de voyage pour la page qui a déclenché cet événement.

  • pVisibleListEntriesComplete Liste contenant les nouvelles entrées du journal de voyage depuis la dernière mise à jour.

  • cVisibleListEntriesComplete Nombre d’éléments dans pVisibleListEntriesComplete

OnTabCrashed

Déclenché lorsque l’onglet s’est bloqué.

public HRESULT OnTabCrashed(BOOL fUnrecoverable)

Paramètres
  • fUnrecoverable Indique si l’onglet est récupérable.

OnTabHangReported

Déclenché lorsque le navigateur est bloqué.

public HRESULT OnTabHangReported()

OnUnexpectedRundown

Déclenché lorsque le navigateur s’est fermé de manière inattendue.

public HRESULT OnUnexpectedRundown()

OnUnhandledKeyboardAccelerator

Déclenché lors du traitement d’un accélérateur clavier et il est déterminé que le navigateur ne gère pas ou ne doit pas se baser sur rgHostPriorityAccels.

public HRESULT OnUnhandledKeyboardAccelerator(LPMSG lpMsg)

Paramètres
  • lpMsg Message win32 pour l’accélérateur clavier non géré.

OnUnhandledKeyboardAcceleratorAsync

Déclenché lors du traitement d’un accélérateur clavier et il est déterminé que le navigateur ne gère pas ou ne doit pas se baser sur rgHostPriorityAccels.

public HRESULT OnUnhandledKeyboardAcceleratorAsync(LPMSG pMsg, BOOL isShiftDown, BOOL isCtrlDown, BOOL isAltDown)

Dans cette version de la méthode, l’événement est déclenché de façon asynchrone et l’état du clavier a peut-être changé depuis qu’il a été traité, de sorte que l’état des touches de modification est fourni.

Paramètres

  • pMsg Message win32 pour l’accélérateur clavier non géré.

  • isShiftDown Indique si la touche Maj a été enfoncée.

  • isCtrlDown Indique si la touche Ctrl a été enfoncée.

  • isAltDown Indique si la touche Alt a été enfoncée.

OnVisibleComplete

Déclenché lorsque le contenu de la page est rendu visible.

public HRESULT OnVisibleComplete()

OnZoomChanged

Déclenché lorsque le zoom a changé.

public HRESULT OnZoomChanged(ULONG ulZoomPercent)

Paramètres
  • ulZoomPercent Nouveau pourcentage de zoom.

OpenURLInEdge

Déclenché lorsque le navigateur demande à l’hôte d’accéder à une URL dans une nouvelle fenêtre.

public HRESULT OpenURLInEdge(LPCWSTR pszUrl, const DualEngineNewWindowOptions * options, ULONG ulCookieSyncVersion)

Paramètres

  • pszUrl URL à laquelle accéder.

  • options Options à appliquer à la nouvelle fenêtre.

  • ulCookieSyncVersion Nombre qui peut être utilisé pour mettre en corrélation une navigation avec un état de cookie spécifique.

OpenURLInEdge2

Déclenché lorsque le navigateur demande à l’hôte d’accéder à une URL dans une nouvelle fenêtre ; cette version fournit des informations supplémentaires sur la navigation.

public HRESULT OpenURLInEdge2(LPCWSTR pszUrl, const DualEngineNewWindowOptions * options, ULONG ulCookieSyncVersion, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Paramètres

  • pszUrl URL à laquelle accéder.

  • options Options à appliquer à la navigation.

  • ulCookieSyncVersion Nombre qui peut être utilisé pour mettre en corrélation une navigation avec un état de cookie spécifique.

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

  • pszHeaders En-têtes HTTP supplémentaires.

  • postData Données HTTP POST, telles que les données de formulaire.

RequestHostAddFavorite

Déclenché lorsqu’une page a été demandée pour être ajoutée aux favoris.

public HRESULT RequestHostAddFavorite(LPCWSTR pszTitle, LPCWSTR pszUrl)

Paramètres

  • pszTitle Titre de la page.

  • pszUrl URL de la page.

RequestHostCreateUrlTip

Déclenché lors de la demande d’affichage d’une info-bulle contenant une URL.

public HRESULT RequestHostCreateUrlTip(LPCWSTR pszUrl)

Paramètres
  • pszUrl URL à afficher dans l’info-bulle.

RequestHostFocus

Déclenché lorsque le focus est demandé pour passer à la fenêtre hôte.

public HRESULT RequestHostFocus(DUALENGINE_FOCUSDIRECTION focusDirection, const MSG * msg)

Paramètres

  • focusDirection Direction dans laquelle le focus se déplace.

  • msg Pointeur vers le message qui a provoqué le changement de focus.

RequestHostFullscreen

Déclenché lorsque la page demande que l’hôte affiche le contenu en plein écran.

public HRESULT RequestHostFullscreen(FULLSCREENACTION fullScreenAction)

Paramètres
  • fullScreenAction Action plein écran demandée.

RequestHostHideUrlTip

Déclenché lors de la demande de masquer une info-bulle contenant une URL.

public HRESULT RequestHostHideUrlTip()

RequestHostPositionChanged

Déclenché lorsque le navigateur demande que l’hôte change sa taille ou sa position.

public HRESULT RequestHostPositionChanged(LONG nX, LONG nY, LONG nWidth, LONG nHeight, ULONGLONG hSyncEvent)

Paramètres

  • nX Position X de la fenêtre demandée.

  • nY Position Y de la fenêtre demandée.

  • nWidth Largeur de fenêtre demandée.

  • nHeight Hauteur de fenêtre demandée.

  • hSyncEvent Handle de l’objet d’événement qui doit être signalé une fois la modification terminée.

RequestHostShowTheater

Déclenché lorsque le navigateur demande à l’hôte d’entrer ou de quitter le mode théâtre.

public HRESULT RequestHostShowTheater(BOOL fShow)

Paramètres
  • fShow Si truela valeur est , l’hôte est invité à passer en mode théâtre ; si false, il est demandé de quitter le mode théâtre.

RequestHostWindowFocus

Déclenché lorsque l’hôte est invité à prendre ou à abandonner le focus.

public HRESULT RequestHostWindowFocus(BOOL fFocus)

Paramètres
  • fFocus Indique ce qui doit être fait avec le focus. Si truela valeur est , le focus doit être mis en place ; sinon, il doit être abandonnée.

RequestHostWindowFocusSync

Déclenché lorsque l’hôte est invité à prendre ou à abandonner le focus.

public HRESULT RequestHostWindowFocusSync(BOOL fFocus, ULONGLONG hSyncEvent)

Dans cette version de la méthode, le navigateur attend que l’événement fourni soit signalé.

Paramètres

  • fFocus Indique ce qui doit être fait avec le focus. Si truela valeur est , le focus doit être mis en place ; sinon, il doit être abandonnée.

  • hSyncEvent Handle de l’objet d’événement qui doit être signalé une fois la modification terminée.

UpdateHostFavicon

Déclenché lorsque le favicon a changé.

public HRESULT UpdateHostFavicon(ULONG ulCurrentEntryId, LPCWSTR spszCurrentUrl, LPCWSTR * pIconUrls, int cIconUrls)

Paramètres

  • ulCurrentEntryId ID d’entrée du journal de voyage pour la page qui a déclenché cet événement.

  • spszCurrentUrl URL de la page.

  • pIconUrls Liste d’URL de favicon.

  • cIconUrls Nombre d’éléments dans pIconUrls.

UpdateHostTitle

Déclenché lorsque le titre de la page a été mis à jour.

public HRESULT UpdateHostTitle(ULONG ulCurrentEntryId, LPCWSTR pszTitle)

Paramètres

  • ulCurrentEntryId ID de la page dans la liste des entrées visibles qui a déclenché cet événement.

  • pszTitle Nouveau titre.

UpdateSecureLockIcon

Déclenché lorsque les informations de sécurité de la page ont changé.

public HRESULT UpdateSecureLockIcon(ULONG ulCurrentEntryId, SECURELOCKICON secureLockIcon)

Paramètres

  • ulCurrentEntryId Entrée de journal de voyage pour cette modification.

  • secureLockIcon État des informations de sécurité.