WebBrowser.NewWindow 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 antes que uma nova janela do navegador seja aberta.
public:
event System::ComponentModel::CancelEventHandler ^ NewWindow;public event System.ComponentModel.CancelEventHandler NewWindow;public event System.ComponentModel.CancelEventHandler? NewWindow;member this.NewWindow : System.ComponentModel.CancelEventHandler Public Custom Event NewWindow As CancelEventHandler Public Event NewWindow As CancelEventHandler 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 NewWindow evento. Este relatório ajuda você a aprender 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 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 NewWindow evento.
private void WebBrowser1_NewWindow(Object sender, CancelEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "NewWindow Event" );
}
Private Sub WebBrowser1_NewWindow(sender as Object, e as CancelEventArgs) _
Handles WebBrowser1.NewWindow
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"NewWindow Event")
End Sub
Comentários
O WebBrowser controle abre uma janela separada do navegador quando a sobrecarga apropriada do Navigate método é chamada ou quando o usuário clica na opção Abrir em Nova Janela do menu de atalho do navegador quando o ponteiro do mouse passa o mouse sobre um hiperlink. Você pode desabilitar o menu de atalho definindo a IsWebBrowserContextMenuEnabled propriedade como false.
O NewWindow evento ocorre antes que a nova janela do navegador seja aberta. Você pode lidar com esse evento, por exemplo, para impedir que a janela seja aberta quando determinadas condições não forem atendidas.
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.
