WebBrowser.DocumentCompleted Evento

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se produce cuando el control WebBrowser termina de cargar un 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

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este evento para imprimir un documento una vez cargado por completo.

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

Comentarios

El WebBrowser control navega a un nuevo documento cada vez que se establece una de las siguientes propiedades o se llama a métodos:

Controle el DocumentCompleted evento para recibir notificaciones cuando el nuevo documento termine de cargarse. Cuando se produce el DocumentCompleted evento, el nuevo documento se carga por completo, lo que significa que puede tener acceso a su contenido a través de la Documentpropiedad , DocumentTexto DocumentStream .

Para recibir notificaciones antes de que comience la navegación, controle el Navigating evento. Controlar este evento le permite cancelar la navegación si no se han cumplido ciertas condiciones, por ejemplo, cuando el usuario no ha rellenado completamente un formulario. Controle el Navigated evento para recibir la notificación cuando el control finalice la WebBrowser navegación y haya comenzado a cargar el documento en la nueva ubicación.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Se aplica a

Compartir vía