CanGoForwardChanged Event

WebBrowser.CanGoForwardChanged Event

 

Occurs when the CanGoForward property value changes.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public event EventHandler CanGoForwardChanged

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.

The following code example demonstrates how to use the GoForward method to implement a Forward button for the WebBrowser control that is similar to the Forward button 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.
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;
}

SecurityPermission

for immediate callers to use this control. Demand value: LinkDemand; NIB: Named Permission Sets: FullTrust.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft