WebBrowser.DocumentCompleted Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vyvolá se, WebBrowser když ovládací prvek dokončí načítání 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
Event Type
Příklady
Následující příklad kódu ukazuje použití této události k tisku dokumentu po jeho úplném načtení.
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
Poznámky
Ovládací WebBrowser prvek přejde do nového dokumentu vždy, když je nastavena jedna z následujících vlastností nebo je volána metoda:
DocumentCompleted Zpracování události pro příjem oznámení po dokončení načítání nového dokumentu Když dojde k DocumentCompleted události, nový dokument je plně načten, což znamená, že k jeho obsahu máte přístup prostřednictvím Documentvlastnosti , DocumentTextnebo DocumentStream .
Pokud chcete dostávat oznámení před zahájením navigace, zpracujte Navigating událost. Zpracování této události umožňuje zrušit navigaci, pokud nebyly splněny určité podmínky, například když uživatel zcela nevyplnil formulář. Navigated Zpracování události pro příjem oznámení, když WebBrowser ovládací prvek dokončí navigaci a začne načítat dokument v novém umístění.
Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.