WebBrowser.CanGoForward プロパティとは何？わかりやすく解説 Weblio辞書

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

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

WebBrowser.CanGoForward プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ナビゲーション履歴に次のページがあるかどうかを示す値を取得します。この値により、GoForward メソッドが成功するかどうかが決まります。

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

Visual Basic (宣言)

Public ReadOnly Property
 CanGoForward As Boolean

Visual Basic (使用法)

Dim instance As WebBrowser
Dim value As Boolean

value = instance.CanGoForward

public bool CanGoForward { get;
 }

C++

public:
property bool CanGoForward {
    bool get ();
}

/** @property */
public boolean get_CanGoForward ()

JScript

public function get CanGoForward
 () : boolean

プロパティ値
次のページに進むことができる場合は true。それ以外の場合は false。

解説

WebBrowser コントロールは、ブラウジングセッション時に閲覧したすべての Web ページの履歴リストを保持します。前述した前に戻るナビゲーションの結果、履歴に次のページが存在する場合、GoForward メソッドを使用すると WebBrowser コントロールは履歴の次のページに進みます。このプロパティが true の場合、GoForward メソッドは成功します。それ以外の場合、GoForward メソッドを呼び出すと値 false が返され、ナビゲーションは実行されません。

CanGoForward プロパティを使用して、ナビゲーション履歴を利用できるかどうか、そして現在のページの後に当たるページが存在するかどうかを判断します。これにより、GoForward メソッドが成功するかどうかが決まります。

また CanGoForwardChanged イベントを処理すると、CanGoForward プロパティが変更されたときに通知を受け取ることもできます。たとえば、WebBrowser コントロールでナビゲーション履歴の最後のページに移動したとき、またはそのページから移動したときに [進む] ボタンの有効状態を変更する場合に、このイベントが役立ちます。

使用例

CanGoForward イベントのハンドラを使用して、Internet Explorer の [進む] ボタンのような [Forward] ボタンを WebBrowser コントロールに実装する方法を次のコード例に示します。この例は、フォームに webBrowser1 という名前の WebBrowser コントロールと、ButtonForward という名前の Button コントロールが存在することを前提にしています。

コード全体については、「方法 : Windows フォームアプリケーションに Web ブラウザの機能を追加する」を参照してください。

Visual Basic

' Navigates webBrowser1 to the next page in history.
Private Sub forwardButton_Click( _
    ByVal sender As Object,
 ByVal e As EventArgs) _
    Handles forwardButton.Click

    webBrowser1.GoForward()

End Sub

' Disables the Forward button at the end of navigation history.
Private Sub webBrowser1_CanGoForwardChanged(
 _
    ByVal sender As Object,
 ByVal e As EventArgs) _
    Handles webBrowser1.CanGoForwardChanged

    forwardButton.Enabled = webBrowser1.CanGoForward

End Sub

// Navigates webBrowser1 to the next page in history.
private void forwardButton_Click(object sender,
 EventArgs e)
{
    webBrowser1.GoForward();
}

// Disables the Forward button at the end of navigation history.
private void webBrowser1_CanGoForwardChanged(object
 sender, EventArgs e)
{
    forwardButton.Enabled = webBrowser1.CanGoForward;
}

C++

// Navigates WebBrowser1 to the next page in history.
void ButtonForward_Click( System::Object^ /*sender*/, System::EventArgs^
 /*e*/ )
{
   this->WebBrowser1->GoForward();
}

// Disables the Forward button at the end of navigation history.
void WebBrowser1_CanGoForwardChanged( System::Object^ /*sender*/,
 System::EventArgs^ /*e*/ )
{
   this->ButtonForward->Enabled = this->WebBrowser1->CanGoForward;
}