WebBrowser.CanGoBack プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ナビゲーション履歴の前のページを使用できるかどうかを示す値を取得します。これにより、 GoBack() メソッドが成功します。
public:
property bool CanGoBack { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool CanGoBack { get; }
[<System.ComponentModel.Browsable(false)>]
member this.CanGoBack : bool
Public ReadOnly Property CanGoBack As Boolean
プロパティ値
true コントロールが後方に移動できる場合。それ以外の場合は false。
- 属性
例
次のコード例では、CanGoBack プロパティを使用して、Internet Explorer と同様のWebBrowser コントロールの [戻る] ボタンを実装する方法を示します。 この例では、フォームに webBrowser1 と呼ばれるWebBrowser コントロールと、backButton というButton コントロールが含まれている必要があります。
完全なコード例については、「 方法: Windows フォーム アプリケーションに Web ブラウザー機能を追加する」を参照してください。
// Navigates WebBrowser1 to the previous page in the history.
void backButton_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
this->WebBrowser1->GoBack();
}
// Disables the Back button at the beginning of the navigation history.
void WebBrowser1_CanGoBackChanged( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
this->backButton->Enabled = this->WebBrowser1->CanGoBack;
}
// Navigates webBrowser1 to the previous page in the history.
private void backButton_Click(object sender, EventArgs e)
{
webBrowser1.GoBack();
}
// Disables the Back button at the beginning of the navigation history.
private void webBrowser1_CanGoBackChanged(object sender, EventArgs e)
{
backButton.Enabled = webBrowser1.CanGoBack;
}
' Navigates webBrowser1 to the previous page in the history.
Private Sub backButton_Click( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles backButton.Click
webBrowser1.GoBack()
End Sub
' Disables the Back button at the beginning of the navigation history.
Private Sub webBrowser1_CanGoBackChanged( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles webBrowser1.CanGoBackChanged
backButton.Enabled = webBrowser1.CanGoBack
End Sub
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。
GoBack メソッドは、WebBrowser コントロールをこの履歴の前のページ (使用可能な場合) に移動します。
CanGoBack プロパティを使用して、ナビゲーション履歴が使用可能で、前のページが含まれているかどうかを確認します。 このプロパティが true場合、 GoBack メソッドは成功します。 それ以外の場合、 GoBack メソッドを呼び出すと、 false の値が返され、ナビゲーションは行われません。
CanGoBackChanged イベントを処理して、CanGoBack プロパティが変更されたときに通知を受信することもできます。 このイベントの処理は、たとえば、WebBrowser コントロールがナビゲーション履歴の先頭に移動または移動するときに、[戻る] ボタンの有効な状態を変更する場合に便利です。