WebBrowser.DocumentCompleted Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда WebBrowser элемент управления завершит загрузку документа.
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 Тип события
Примеры
В следующем примере кода показано использование этого события для печати документа после его полной загрузки.
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
Комментарии
Элемент WebBrowser управления переходит к новому документу при каждом вызове одного из следующих свойств или методов:
Обработайте DocumentCompleted событие для получения уведомления после завершения загрузки нового документа. DocumentCompleted При возникновении события новый документ полностью загружен, что означает, что вы можете получить доступ к его содержимому Documentчерез свойство DocumentTextили DocumentStream свойство.
Чтобы получить уведомление перед началом навигации, обработайте Navigating событие. Обработка этого события позволяет отменить навигацию, если некоторые условия не выполнены, например, если пользователь не полностью заполнял форму. Обработайте Navigated событие для получения уведомлений, когда WebBrowser элемент управления завершит навигацию и начал загрузку документа в новом расположении.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".
