WebBrowser.CanGoForwardChanged Event

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Occurs when the CanGoForward property value changes.

public:
 event EventHandler ^ CanGoForwardChanged;

[System.ComponentModel.Browsable(false)]
public event EventHandler? CanGoForwardChanged;

[<System.ComponentModel.Browsable(false)>]
member this.CanGoForwardChanged : EventHandler 

Public Event CanGoForwardChanged As EventHandler 

Event Type

EventHandler

Attributes

BrowsableAttribute

Examples

The following code example demonstrates how to use the GoForward method 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. The CanGoForward property indicates whether navigation history is available and contains a page located after the current one, allowing the GoForward method to succeed. 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.

For more information about handling events, see Handling and Raising Events.

See also

• CanGoForward
• EventArgs
• EventHandler
• GoForward()