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

Traductions disponibles Traductions disponibles
Numéro d'article: 180366 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

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 If
    End 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 event
void 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;
   }
}
				

Propriétés

Numéro d'article: 180366 - Dernière mise à jour: jeudi 1 juillet 2004 - Version: 2.1
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • 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
Mots-clés : 
kbmt kbhowto KB180366 KbMtfr
Traduction automatique
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
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.
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.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com