Edit

Share via


WebBrowser.CanGoForward Property

Definition

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

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

Attributes

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

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

See also