WebBrowser.CanGoForwardChanged WebBrowser.CanGoForwardChanged WebBrowser.CanGoForwardChanged WebBrowser.CanGoForwardChanged Event

Definition

Occurs when the CanGoForward property value changes.

public:
 event EventHandler ^ CanGoForwardChanged;
[System.ComponentModel.Browsable(false)]
public event EventHandler CanGoForwardChanged;
member this.CanGoForwardChanged : EventHandler 
Public Event CanGoForwardChanged As EventHandler 
Attributes

Examples

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.
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.

Security

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

Applies to

See also