This topic has not yet been rated - Rate this topic

WebBrowser.CanGoBackChanged Event

Occurs when the CanGoBack property value changes.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[BrowsableAttribute(false)]
public event EventHandler CanGoBackChanged

The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. The GoBack method navigates the WebBrowser control to the previous page in this history, if one is available. The CanGoBack property indicates whether navigation history is available and contains a previous page. Handle the CanGoBackChanged event to receive a notification when the CanGoBack property changes. Handling this event is useful, for example, to change the enabled state of a Back button when the WebBrowser control navigates to or leaves the beginning of the navigation history.

For more information about handling events, see Consuming Events.

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

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

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.