WebBrowser.DocumentCompleted Evento

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Ocorre quando o controlo WebBrowser termina de carregar um documento.

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 seguinte demonstra a utilização deste evento para imprimir um documento depois de este estar 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

Observações

O WebBrowser controlo navega para um novo documento sempre que uma das seguintes propriedades ou métodos é chamada:

Trate do DocumentCompleted evento para receber notificações quando o novo documento terminar de carregar. Quando o DocumentCompleted evento ocorre, o novo documento está totalmente carregado, o que significa que pode aceder ao seu conteúdo através da Documentpropriedade , DocumentText, ou DocumentStream .

Para receber notificações antes do início da navegação, trate do Navigating evento. Gerir este evento permite-lhe cancelar a navegação se certas condições não forem cumpridas, por exemplo, quando o utilizador não preencheu completamente um formulário. Trate do Navigated evento para receber notificação quando o WebBrowser controlo terminar a navegação e começar a carregar o documento na nova localização.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Aplica-se a

Ver também