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 происходит до открытия нового окна браузера. Это событие можно обрабатывать, например, чтобы предотвратить открытие окна, если определенные условия не выполнены.
Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".