WebBrowser.CanGoForward Propriété

Définition

Obtient une valeur indiquant si une page suivante dans l'historique de navigation est disponible, ce qui permet à la méthode GoForward() de réussir.

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

Valeur de propriété

true si le contrôle peut naviguer vers l'avant ; sinon, false.

Attributs

Exemples

L’exemple de code suivant montre comment utiliser un gestionnaire pour l’événement CanGoForward afin d’implémenter un bouton Transférer pour le WebBrowser contrôle similaire à celui dans Internet Explorer. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1 et un Button contrôle appelé ButtonForward.

Pour obtenir l’exemple de code complet, consultez 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

Remarques

Le WebBrowser contrôle conserve une liste d’historique de toutes les pages Web visitées pendant une session de navigation. La GoForward méthode navigue le WebBrowser contrôle vers la page suivante de cet historique, si elle est disponible à la suite d’une navigation précédente vers l’arrière. Si cette propriété a la valeur true, la GoForward méthode réussit. Sinon, l’appel de la GoForward méthode renvoie la valeur et false aucune navigation n’est effectuée.

Utilisez la CanGoForward propriété pour déterminer si l’historique de navigation est disponible et contient une page située après celle en cours, ce qui permet à la GoForward méthode de réussir.

Vous pouvez également gérer l’événement CanGoForwardChanged pour recevoir une notification lorsque la CanGoForward propriété change. La gestion de cet événement est utile, par exemple, pour modifier l’état activé d’un bouton Transférer lorsque le WebBrowser contrôle navigue vers ou quitte la fin de l’historique de navigation.

S’applique à

Voir aussi