WebBrowser.ProgressChanged 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 tem informações atualizadas sobre o andamento do download de um documento para o qual está navegando.
public:
event System::Windows::Forms::WebBrowserProgressChangedEventHandler ^ ProgressChanged;
public event System.Windows.Forms.WebBrowserProgressChangedEventHandler ProgressChanged;
public event System.Windows.Forms.WebBrowserProgressChangedEventHandler? ProgressChanged;
member this.ProgressChanged : System.Windows.Forms.WebBrowserProgressChangedEventHandler
Public Custom Event ProgressChanged As WebBrowserProgressChangedEventHandler
Public Event ProgressChanged As WebBrowserProgressChangedEventHandler
Tipo de evento
Exemplos
O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do ProgressChanged evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo WebBrowser chamada WebBrowser1
. Em seguida, verifique se o manipulador de eventos está associado ao ProgressChanged evento.
private void WebBrowser1_ProgressChanged(Object sender, WebBrowserProgressChangedEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentProgress", e.CurrentProgress );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "MaximumProgress", e.MaximumProgress );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ProgressChanged Event" );
}
Private Sub WebBrowser1_ProgressChanged(sender as Object, e as WebBrowserProgressChangedEventArgs) _
Handles WebBrowser1.ProgressChanged
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "CurrentProgress", e.CurrentProgress)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "MaximumProgress", e.MaximumProgress)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"ProgressChanged Event")
End Sub
Comentários
Você pode usar um manipulador para esse evento para implementar uma barra de progresso de navegação semelhante à da Internet Explorer. Use a WebBrowserProgressChangedEventArgs.CurrentProgress propriedade para determinar o número de bytes que foram baixados com êxito. Use a WebBrowserProgressChangedEventArgs.MaximumProgress propriedade para determinar o número total de bytes disponíveis para download.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.