WebBrowser.DocumentCompleted Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o controle WebBrowser termina de carregar um documento.
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
Tipo de evento
Exemplos
O exemplo de código a seguir demonstra o uso desse evento para imprimir um documento depois de ter sido totalmente carregado.
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
Comentários
O WebBrowser controle navega para um novo documento sempre que uma das seguintes propriedades é definida ou os métodos são chamados:
Manipule o DocumentCompleted evento para receber notificação quando o novo documento terminar de carregar. Quando o DocumentCompleted evento ocorre, o novo documento é totalmente carregado, o que significa que você pode acessar seu conteúdo por meio da Documentpropriedade , DocumentTextou DocumentStream .
Para receber notificação antes do início da navegação, manipule o Navigating evento. Lidar com esse evento permite cancelar a navegação se determinadas condições não tiverem sido atendidas, por exemplo, quando o usuário não preencheu completamente um formulário. Manipule o Navigated evento para receber notificação quando o controle concluir a WebBrowser navegação e começar a carregar o documento no novo local.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.