WebBrowser.NewWindow Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit avant l'ouverture d'une nouvelle fenêtre de navigateur.
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 Type d'événement
Exemples
L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement NewWindow . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider dans le débogage. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer par ou d’ajouter le message à un message multiligne TextBox.
Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type WebBrowser nommé WebBrowser1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement 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
Remarques
Le WebBrowser contrôle ouvre une fenêtre de navigateur distincte lorsque la surcharge appropriée de la Navigate méthode est appelée ou lorsque l’utilisateur clique sur l’option Ouvrir dans la nouvelle fenêtre du menu contextuel du navigateur lorsque le pointeur de la souris pointe sur un lien hypertexte. Vous pouvez désactiver le menu contextuel en définissant la IsWebBrowserContextMenuEnabled propriété sur false.
L’événement NewWindow se produit avant l’ouverture de la nouvelle fenêtre du navigateur. Vous pouvez gérer cet événement, par exemple, pour empêcher l’ouverture de la fenêtre lorsque certaines conditions n’ont pas été remplies.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
