Edit

Share via

WebBrowser.CanGoForward Property

  • Reference

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gets a value indicating whether a subsequent page in navigation history is available, which allows the GoForward() method to succeed.

public:
 property bool CanGoForward { bool get(); };
[System.ComponentModel.Browsable(false)]
public bool CanGoForward { get; }
[<System.ComponentModel.Browsable(false)>]
member this.CanGoForward : bool
Public ReadOnly Property CanGoForward As Boolean

Property Value

Boolean

true if the control can navigate forward; otherwise, false.

Attributes
BrowsableAttribute

Examples

The following code example demonstrates how to use a handler for the CanGoForward event to implement a Forward button for the WebBrowser control similar to the one in Internet Explorer. This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonForward.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

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

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

' 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

Remarks

The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. The GoForward method navigates the WebBrowser control to the next page in this history, if one is available as a result of a previous backward navigation. If this property is true, the GoForward method will succeed. Otherwise, calling the GoForward method will return a value of false and no navigation will occur.

Use the CanGoForward property to determine whether navigation history is available and contains a page located after the current one, allowing the GoForward method to succeed.

You can also handle the CanGoForwardChanged event to receive a notification when the CanGoForward property changes. Handling this event is useful, for example, to change the enabled state of a Forward button when the WebBrowser control navigates to or leaves the end of the navigation history.

Applies to

See also