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 когда элемент управления завершит навигацию и начнет загрузку документа в новом расположении.
Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.