WebBrowser.CanGoForward プロパティ

.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

C#

public bool CanGoForward { get;
 }

C++

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

J#

/** @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

C#

// 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;
}

.NET Framework のセキュリティ

• SecurityPermission  (このコントロールを使用する直接の呼び出し元に必要なアクセス許可)。要求値 : LinkDemand、名前付きアクセス許可セット、FullTrust。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
WebBrowser クラス
WebBrowser メンバ
System.Windows.Forms 名前空間
CanGoForwardChanged
GoForward