WebBrowser.DocumentCompleted Evento

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

WebBrowserDocumentCompletedEventHandler

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.

Aplica-se a

Compartilhar via