WebBrowser.NewWindow 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在浏览器新窗口打开之前发生。

public:
 event System::ComponentModel::CancelEventHandler ^ NewWindow;

public event System.ComponentModel.CancelEventHandler? NewWindow;

member this.NewWindow : System.ComponentModel.CancelEventHandler 

Public Event NewWindow As CancelEventHandler 

事件类型

CancelEventHandler

示例

下面的代码示例演示了此成员的用法。 在此示例中，事件处理程序报告事件的发生情况 NewWindow 。 此报告可帮助你了解事件发生的时间，并可以帮助你进行调试。 若要报告多个事件或频繁发生的事件，请考虑将 MessageBox.ShowConsole.WriteLine 消息替换为 或将消息追加到多行 TextBox。

若要运行示例代码，请将其粘贴到包含名为 WebBrowser1的类型的WebBrowser实例的项目中。 然后，确保事件处理程序与 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 在打开新浏览器窗口之前发生。 例如，可以处理此事件，以防止窗口在未满足某些条件时打开。

有关处理事件的详细信息，请参阅 处理和引发事件。

另请参阅

• CancelEventArgs
• CancelEventHandler
• IsWebBrowserContextMenuEnabled
• Navigate