WebBrowser.DocumentCompleted Événement

Définition

Se produit lorsque le contrôle WebBrowser finit de charger un document.Occurs when the WebBrowser control finishes loading a document.

public:
 event System::Windows::Forms::WebBrowserDocumentCompletedEventHandler ^ DocumentCompleted;
public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler DocumentCompleted;
member this.DocumentCompleted : System.Windows.Forms.WebBrowserDocumentCompletedEventHandler 
Public Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 
Public Custom Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 

Exemples

L’exemple de code suivant illustre l’utilisation de cet événement pour imprimer un document après son chargement complet.The following code example demonstrates the use of this event to print a document after it has fully loaded.

private void PrintHelpPage()
{
    // Create a WebBrowser instance. 
    WebBrowser webBrowserForPrinting = new WebBrowser();

    // Add an event handler that prints the document after it loads.
    webBrowserForPrinting.DocumentCompleted +=
        new WebBrowserDocumentCompletedEventHandler(PrintDocument);

    // Set the Url property to load the document.
    webBrowserForPrinting.Url = new Uri(@"\\myshare\help.html");
}

private void PrintDocument(object sender,
    WebBrowserDocumentCompletedEventArgs e)
{
    // Print the document now that it is fully loaded.
    ((WebBrowser)sender).Print();

    // Dispose the WebBrowser now that the task is complete. 
    ((WebBrowser)sender).Dispose();
}
Private Sub PrintHelpPage()

    ' Create a WebBrowser instance. 
    Dim webBrowserForPrinting As New WebBrowser()

    ' Add an event handler that prints the document after it loads.
    AddHandler webBrowserForPrinting.DocumentCompleted, New _
        WebBrowserDocumentCompletedEventHandler(AddressOf PrintDocument)

    ' Set the Url property to load the document.
    webBrowserForPrinting.Url = New Uri("\\myshare\help.html")

End Sub

Private Sub PrintDocument(ByVal sender As Object, _
    ByVal e As WebBrowserDocumentCompletedEventArgs)

    Dim webBrowserForPrinting As WebBrowser = CType(sender, WebBrowser)

    ' Print the document now that it is fully loaded.
    webBrowserForPrinting.Print()
    MessageBox.Show("print")

    ' Dispose the WebBrowser now that the task is complete. 
    webBrowserForPrinting.Dispose()

End Sub

Remarques

Le contrôle WebBrowser navigue vers un nouveau document chaque fois que l’une des propriétés suivantes est définie ou que les méthodes sont appelées :The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

Gérez l’événement DocumentCompleted pour recevoir une notification à la fin du chargement du nouveau document.Handle the DocumentCompleted event to receive notification when the new document finishes loading. Lorsque l’événement DocumentCompleted se produit, le nouveau document est entièrement chargé, ce qui signifie que vous pouvez accéder à son contenu via la propriété Document, DocumentTextou DocumentStream.When the DocumentCompleted event occurs, the new document is fully loaded, which means you can access its contents through the Document, DocumentText, or DocumentStream property.

Pour recevoir une notification avant le début de la navigation, gérez l’événement Navigating.To receive notification before navigation begins, handle the Navigating event. La gestion de cet événement vous permet d’annuler la navigation si certaines conditions n’ont pas été remplies, par exemple lorsque l’utilisateur n’a pas complètement rempli un formulaire.Handling this event lets you cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Gérez l’événement Navigated pour recevoir une notification lorsque le contrôle WebBrowser finit la navigation et a commencé à charger le document au nouvel emplacement.Handle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi