WebBrowser.CanGoBack Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public:
 property bool CanGoBack { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool CanGoBack { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CanGoBack : bool

Public ReadOnly Property CanGoBack As Boolean

Valeur de propriété

Boolean

true si le contrôle peut naviguer en arrière ; sinon, false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la CanGoBack propriété pour implémenter un bouton Précédent 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é backButton.

Pour obtenir l’exemple de code complet, consultez How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates WebBrowser1 to the previous page in the history.
void backButton_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->WebBrowser1->GoBack();
}

// Disables the Back button at the beginning of the navigation history.
void WebBrowser1_CanGoBackChanged( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->backButton->Enabled = this->WebBrowser1->CanGoBack;
}

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

' Navigates webBrowser1 to the previous page in the history.
Private Sub backButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles backButton.Click

    webBrowser1.GoBack()

End Sub

' Disables the Back button at the beginning of the navigation history.
Private Sub webBrowser1_CanGoBackChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles webBrowser1.CanGoBackChanged

    backButton.Enabled = webBrowser1.CanGoBack

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 GoBack méthode navigue le WebBrowser contrôle vers la page précédente de cet historique, le cas échéant. Utilisez la CanGoBack propriété pour déterminer si l’historique de navigation est disponible et contient une page précédente. Si cette propriété a la valeur true, la GoBack méthode réussit. Sinon, l’appel de la GoBack méthode renvoie la valeur et false aucune navigation n’est effectuée.

Vous pouvez également gérer l’événement CanGoBackChanged pour recevoir une notification lorsque la CanGoBack propriété change. La gestion de cet événement est utile, par exemple, pour modifier l’état activé d’un bouton Précédent lorsque le WebBrowser contrôle accède ou quitte le début de l’historique de navigation.

Voir aussi

• CanGoBackChanged
• GoBack()