WebBrowser.CanGoBack Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

WebBrowser.cs

Obtient une valeur indiquant si une page précédente de l’historique de navigation est disponible, ce qui permet à la GoBack() méthode 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 vers l’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 d’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’historiques de toutes les pages Web visitées pendant une session de navigation. La GoBack méthode navigue le contrôle vers la WebBrowser page précédente de cet historique, si elle est disponible. Utilisez la propriété pour déterminer si l’historique CanGoBack de navigation est disponible et contient une page précédente. Si cette propriété est true, la GoBack méthode réussit. Sinon, l’appel de false la GoBack méthode retourne une valeur et aucune navigation ne se produit.

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()