WebBrowserNavigatingEventHandler デリゲートとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebBrowserNavigatingEventHandler デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

WebBrowser コントロールの WebBrowser.Navigating イベントを処理するメソッドを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Delegate Sub WebBrowserNavigatingEventHandler
 ( _
    sender As Object, _
    e As WebBrowserNavigatingEventArgs _
)

Visual Basic (使用法)

Dim instance As New WebBrowserNavigatingEventHandler(AddressOf
 HandlerMethod)

public delegate void WebBrowserNavigatingEventHandler
 (
    Object sender,
    WebBrowserNavigatingEventArgs e
)

C++

public delegate void WebBrowserNavigatingEventHandler
 (
    Object^ sender, 
    WebBrowserNavigatingEventArgs^ e
)

/** @delegate */
public delegate void WebBrowserNavigatingEventHandler
 (
    Object sender, 
    WebBrowserNavigatingEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender: イベントのソース。

e: イベントデータを格納している WebBrowserNavigatingEventArgs。

解説

WebBrowserNavigatingEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。イベントハンドラデリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

WebBrowser.Navigating イベントのハンドラを使用して、Web ページのフォームが入力されていない場合にナビゲーションをキャンセルする方法を次のコード例に示します。WebBrowser.Document プロパティを使用してフォームの入力フィールドに値が含まれているかどうかを判別します。この例は、フォームに webBrowser1 という WebBrowser コントロールが存在することを前提にしています。

Visual Basic

Private Sub Form1_Load(ByVal
 sender As Object, ByVal
 e As EventArgs) _
    Handles Me.Load

    webBrowser1.DocumentText = _
        "<html><body>Please enter your name:<br/>"
 & _
        "<input type='text' name='userName'/><br/>"
 & _
        "<a href='http://www.microsoft.com'>continue</a>"
 & _
        "</body></html>"

End Sub

Private Sub webBrowser1_Navigating( _
    ByVal sender As Object,
 ByVal e As WebBrowserNavigatingEventArgs)
 _
    Handles webBrowser1.Navigating

    Dim document As System.Windows.Forms.HtmlDocument
 = _
        webBrowser1.Document
    If document IsNot Nothing And
 _
        document.All("userName") IsNot Nothing
 And _
        String.IsNullOrEmpty( _
        document.All("userName").GetAttribute("value"))
 Then

        e.Cancel = True
        MsgBox("You must enter your name before you can navigate
 to " & _
            e.Url.ToString())
    End If

End Sub

private void Form1_Load(object sender, EventArgs
 e)
{
    webBrowser1.DocumentText =
        "<html><body>Please enter your name:<br/>" +
        "<input type='text' name='userName'/><br/>" +
        "<a href='http://www.microsoft.com'>continue</a>"
 +
        "</body></html>";
    webBrowser1.Navigating += 
        new WebBrowserNavigatingEventHandler(webBrowser1_Navigating);
}

private void webBrowser1_Navigating(object
 sender, 
    WebBrowserNavigatingEventArgs e)
{
    System.Windows.Forms.HtmlDocument document =
        this.webBrowser1.Document;

    if (document != null && document.All["userName"]
 != null && 
        String.IsNullOrEmpty(
        document.All["userName"].GetAttribute("value")))
    {
        e.Cancel = true;
        System.Windows.Forms.MessageBox.Show(
            "You must enter your name before you can navigate to " +
            e.Url.ToString());
    }
}