WebBrowser.NewWindow Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит перед открытием нового окна браузера.
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
Тип события
Примеры
В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении NewWindow события. Этот отчет поможет вам узнать, когда происходит событие, и поможет вам в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение или добавить его в многостроочный TextBox.
Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа WebBrowser с именем WebBrowser1
. Затем убедитесь, что обработчик событий связан с событием 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
Комментарии
Элемент управления открывает отдельное WebBrowser окно браузера при вызове соответствующей перегрузки Navigate метода или при нажатии пользователем параметра Открыть в новом окне контекстного меню браузера при наведении указателя мыши на гиперссылку. Вы можете отключить контекстное меню, задав IsWebBrowserContextMenuEnabled для свойства значение false.
Событие NewWindow возникает перед открытием нового окна браузера. Это событие можно обработать, например, чтобы предотвратить открытие окна, если не выполнены определенные условия.
Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.