WebBrowser.NewWindow Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre antes de uma nova janela do navegador ser aberta.
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 seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do NewWindow evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo WebBrowser chamada WebBrowser1. Depois, certifique-se de que o gestor 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
Observações
O WebBrowser controlo abre uma janela separada do navegador quando é chamada a sobrecarga Navigate apropriada do método ou quando o utilizador clica na opção Abrir numa Nova Janela do menu de atalhos do navegador, quando o ponteiro do rato paira sobre um hiperlink. Podes desativar o menu de atalhos definindo a IsWebBrowserContextMenuEnabled propriedade para false.
O NewWindow evento ocorre antes de a nova janela do navegador ser aberta. Pode tratar deste evento, por exemplo, para evitar que a janela abra quando certas condições não forem cumpridas.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.