WebBrowser.DocumentCompleted Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy kontrolka WebBrowser kończy ładowanie dokumentu.
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
Typ zdarzenia
Przykłady
Poniższy przykład kodu przedstawia użycie tego zdarzenia do wydrukowania dokumentu po jego pełnym załadowaniu.
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
Uwagi
Kontrolka WebBrowser przechodzi do nowego dokumentu za każdym razem, gdy zostanie ustawiona jedna z następujących właściwości lub zostanie wywołana metoda:
Obsłuż zdarzenie, DocumentCompleted aby otrzymywać powiadomienia po zakończeniu ładowania nowego dokumentu. Po wystąpieniu DocumentCompleted zdarzenia nowy dokument jest w pełni załadowany, co oznacza, że można uzyskać dostęp do jego zawartości za pośrednictwem Documentwłaściwości , DocumentTextlub DocumentStream .
Aby otrzymywać powiadomienia przed rozpoczęciem Navigating nawigacji, obsłuż zdarzenie. Obsługa tego zdarzenia pozwala anulować nawigację, jeśli nie zostały spełnione określone warunki, na przykład gdy użytkownik nie wypełnił całkowicie formularza. Obsłuż zdarzenie, aby otrzymywać powiadomienia po WebBrowser zakończeniu Navigated nawigacji przez kontrolkę i rozpoczęciu ładowania dokumentu w nowej lokalizacji.
Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.