Vous êtes actuellement hors ligne, en attente de reconnexion à Internet.

Comment faire pour déterminer quand une page est terminée chargement dans le contrôle WebBrowser

IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d’articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d’avoir accès, dans votre propre langue, à l’ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s’exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s’efforce aussi continuellement de faire évoluer son système de traduction automatique.

La version anglaise de cet article est la suivante: 180366
Exclusion de responsabilité concernant les contenus obsolètes dans la Base de connaissances
Cet article concerne des produits pour lesquels Microsoft n'offre plus de support. Il est par conséquent fourni « en l'état » et ne sera plus mis à jour.
Résumé
Le contrôle Internet Explorer WebBrowser déclenche l'événement DocumentComplete lorsqu'il a terminé une page Web de téléchargement. Vous pouvez créer une fonction de gestionnaire d'événements dans votre application pour cet événement. Cet article décrit les étapes à suivre pour déterminer si un contrôle WebBrowser est terminé téléchargement d'une page Web.
Plus d'informations
Le contrôle WebBrowser déclenche l'événement DocumentComplete lorsque sa propriété ReadyState est modifiée pour READYSTATE_COMPLETE. Cela indique que le contrôle WebBrowser est terminée téléchargement de la page Web. Voici quelques points importants concernant cet événement :
  • Dans le cas d'une page avec sans cadres, DocumentComplete est déclenché une fois après le tout.
  • En cas de plusieurs images, DocumentComplete obtient déclenché plusieurs fois. Pas toutes les trames déclenchement cet événement, mais chaque trame qui déclenche un événement DownloadBegin déclenche un événement de DocumentComplete correspondant.
  • L'événement DocumentComplete a un paramètre IDispatch *, qui est IDispatch du cadre (shdocvw) pour lequel DocumentComplete est déclenché.
  • Le frame de niveau supérieur déclenche DocumentComplete en fin de compte. Dans ce cas, pour vérifier si une page est effectuée au téléchargement, vous devez vérifier si le paramètre IDispatch * est identique au IDispatch du contrôle WebBrowser.

    Pour Visual Basic, voici le code qui effectue cette vérification :
    Private Sub WebBrowser1_DocumentComplete(ByVal pDisp As Object,                                         URL As Variant)   If (pDisp Is WebBrowser1.Object) Then      Debug.Print "Web document is finished downloading"   End IfEnd Sub					
Pour gérer l'événement DocumentComplete dans Visual C++ et déterminer si le téléchargement de la page Web est terminé, procédez comme suit.

Notez que la procédure à que suivre dépend de la façon dont vous utilisez le contrôle WebBrowser.
  • Si vous créez le contrôle WebBrowser dans un objet CWnd/CView, vous devez suivre les étapes 1 à 4.
  • Si vous créez le contrôle WebBrowser dans un objet CDialog/CFormView, avez uniquement besoin de suivre étape 4.
  • Si vous utilisez la classe CHtmlView fournie avec Visual C++ 6.0, substituer CHtmlView::DocumentComplete() et suivez les étape 4, en utilisant le membre m_pBrowserApp de la classe CHtmlView pour accéder au contrôle WebBrowser.
  1. Définissez la méthode OnDocumentComplete dans le fichier d'en-tête pour votre classe dérivée de CWnd/CView :
    afx_msg void OnDocumentComplete(LPDISPATCH lpDisp,                                VARIANT FAR* URL);					
  2. Déclarez le récepteur d'événements dans le même fichier d'en-tête :
    DECLARE_EVENTSINK_MAP()					
  3. Dans le fichier d'implémentation (.cpp) de votre classe dérivée de CWnd/CView, mettre en oeuvre de la table de récepteur d'événements :
    BEGIN_EVENTSINK_MAP(CYourView, CView)   ON_EVENT(CWBTstView, ID_WEB_BROWSE, 259 /* DocumentComplete */,            OnDocumentComplete, VTS_DISPATCH VTS_PVARIANT)END_EVENTSINK_MAP()					
  4. Implémentez la méthode OnDocumentComplete :
    void CWBTstView::OnDocumentComplete(LPDISPATCH lpDisp,                                    VARIANT FAR* URL){   IUnknown*  pUnk;   LPDISPATCH lpWBDisp;   HRESULT    hr;   pUnk = m_webBrowser.GetControlUnknown();   ASSERT(pUnk);   hr = pUnk->QueryInterface(IID_IDispatch, (void**)&lpWBDisp);   ASSERT(SUCCEEDED(hr));   if (lpDisp == lpWBDisp )   {      // Top-level Window object, so document has been loaded      TRACE("Web document is finished downloading\n");   }  lpWBDisp->Release();}					
Cette approche fonctionne lorsque le contrôle WebBrowser navigue vers une page qui changent le frame de niveau supérieur. Supposons que si la navigation se produit dans un cadre lui-même, alors la DocumentComplete finale est déclenché est celui de l'image et non sur le cadre de niveau supérieur. Par exemple, considérez le scénario suivant.

Le contrôle WebBrowser héberge un jeu de cadres. Dans un châssis du jeu de cadres, l'utilisateur clique sur un lien hypertexte qui ouvre une nouvelle page dans le cadre lui-même et conserve le reste du jeu de cadres intact. La nouvelle page peut contenir plusieurs images à nouveau. Par conséquent, il y aura plusieurs notifications DocumentComplete (une pour chaque nouveau cadre). Mais, étant donné que le frame de niveau supérieur n'a pas modifié, DocumentComplete finale serait que du cadre qui a été modifié.

Si vous souhaitez pour le contrôle pour le document final complet dans ce scénario, vous pouvez procéder de la manière suivante :
Vérifiez si le paramètre IDispatch de la DocumentComplete est identique au paramètre de IDispatch du premier événement NavigateComplete2. Puisque NavigateComplete2 premier est de la trame de niveau supérieur et DocumentComplete dernière est également de la trame de niveau supérieur, effectuant une comparaison de cette manière indiquera si la page est effectuée téléchargement.
Voici un exemple de code C++:
LPDISPATCH glpDisp = NULL; // global LPDISPATCH, can also                           // be of class scope// NavigateComplete2 eventvoid CWebbrDlg::OnNavigateComplete2Explorer1(LPDISPATCH pDisp,                                             VARIANT FAR* URL){   // Check if glpDisp is NULL. If NULL, that means it is   // the top level NavigateComplete2. Save the LPDISPATCH   if (!glpDisp)      glpDisp = pDisp;}void CWebbrDlg::OnDocumentCompleteExplorer1(LPDISPATCH pDisp,                                            VARIANT FAR* URL){   if (glpDisp && glpDisp == pDisp)   {      // if the LPDISPATCH are same, that means      // it is the final DocumentComplete. Reset glpDisp      TRACE("Document is done downloading");      glpDisp = NULL;   }}				
DocumentComplete

Warning: This article has been translated automatically

Propriétés

ID d'article : 180366 - Dernière mise à jour : 07/01/2004 16:33:16 - Révision : 2.1

Microsoft Internet Explorer 4.0 Édition 128 bits, Microsoft Internet Explorer 4.01 Service Pack 2, Microsoft Internet Explorer 5.0, Microsoft Internet Explorer 5.5

  • kbmt kbhowto KB180366 KbMtfr
Commentaires