WebBrowser.NewWindow Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica prima dell'apertura di una nuova finestra del browser.
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 evento
Esempio
Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento NewWindow . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.
Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo WebBrowser denominata WebBrowser1
. Assicurarsi quindi che il gestore eventi sia associato all'evento NewWindow .
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
Commenti
Il WebBrowser controllo apre una finestra del browser separata quando viene chiamato l'overload appropriato del Navigate metodo o quando l'utente fa clic sull'opzione Apri in nuova finestra del menu di scelta rapida del browser quando il puntatore del mouse passa il mouse su un collegamento ipertestuale. È possibile disabilitare il menu di scelta rapida impostando la IsWebBrowserContextMenuEnabled proprietà su false.
L'evento NewWindow si verifica prima dell'apertura della nuova finestra del browser. È possibile gestire questo evento, ad esempio, per impedire l'apertura della finestra quando non sono state soddisfatte determinate condizioni.
Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.