WebBrowser.NewWindow Evento
Definición
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 antes de que se abra una nueva ventana del explorador.
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
Ejemplos
En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos informa sobre la aparición del NewWindow evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.ShowConsole.WriteLine por o anexar el mensaje a una línea TextBoxmúltiple.
Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo WebBrowser denominada WebBrowser1
. A continuación, asegúrese de que el controlador de eventos está asociado al 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
Comentarios
El WebBrowser control abre una ventana del explorador independiente cuando se llama a la sobrecarga adecuada del Navigate método o cuando el usuario hace clic en la opción Abrir en nueva ventana del menú contextual del explorador cuando el puntero del mouse mantiene el puntero sobre un hipervínculo. Puede deshabilitar el menú contextual estableciendo la IsWebBrowserContextMenuEnabled propiedad en false.
El NewWindow evento se produce antes de que se abra la nueva ventana del explorador. Puede controlar este evento, por ejemplo, para evitar que la ventana se abra cuando no se cumplan ciertas condiciones.
Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.