WebBrowser.DocumentCompleted Événement

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Se produit lorsque le contrôle WebBrowser finit de charger un document.

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

Type d'événement

WebBrowserDocumentCompletedEventHandler

Exemples

L’exemple de code suivant illustre l’utilisation de cet événement pour imprimer un document après son chargement complet.

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 WebBrowser contrôle accède à un nouveau document chaque fois que l’une des propriétés suivantes est définie ou que des méthodes sont appelées :

Gérez l’événement DocumentCompleted pour recevoir une notification à la fin du chargement du nouveau document. 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 Documentpropriété , DocumentTextou DocumentStream .

Pour recevoir une notification avant le début de la navigation, gérez l’événement Navigating . 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. Gérez l’événement Navigated pour recevoir une notification lorsque le WebBrowser contrôle a terminé la navigation et a commencé à charger le document au nouvel emplacement.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Voir aussi