WebBrowser.DocumentCompleted Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque le contrôle termine le WebBrowser chargement d’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
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 qu’une des propriétés suivantes est définie ou que des méthodes sont appelées :
Gérez l’événement pour recevoir une DocumentCompleted notification lorsque le nouveau document termine le chargement. Lorsque l’événement DocumentCompleted se produit, le nouveau document est entièrement chargé, ce qui signifie que vous pouvez accéder à son contenu par le biais du , Documentou DocumentText de la DocumentStreampropriété.
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 rempli complètement un formulaire. Gérez l’événement pour recevoir une Navigated notification lorsque le contrôle termine la WebBrowser navigation et a commencé à charger le document à l’emplacement nouveau.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
