WebBrowser.CanGoBack Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene un valore che indica se nella cronologia di spostamento è presente una pagina precedente, determinando così l'esito positivo del metodo GoBack().

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

Valore della proprietà

Boolean

true se il controllo consente lo spostamento indietro; in caso contrario, false.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la CanGoBack proprietà per implementare un pulsante Indietro per il WebBrowser controllo simile a quello in Internet Explorer. In questo esempio è necessario che il form contenga un WebBrowser controllo denominato webBrowser1 e un Button controllo denominato backButton.

Per l'esempio di codice completo, vedere Procedura: Aggiungere funzionalità del Web browser a un'applicazione Windows Forms.

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

Commenti

Il WebBrowser controllo mantiene un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione. Il GoBack metodo sposta il WebBrowser controllo alla pagina precedente di questa cronologia, se disponibile. Utilizzare la CanGoBack proprietà per determinare se la cronologia di navigazione è disponibile e contiene una pagina precedente. Se questa proprietà è true, il GoBack metodo avrà esito positivo. In caso contrario, la chiamata al GoBack metodo restituirà un valore e false non verrà eseguita alcuna navigazione.

È anche possibile gestire l'evento CanGoBackChanged per ricevere una notifica quando la CanGoBack proprietà viene modificata. La gestione di questo evento è utile, ad esempio, per modificare lo stato abilitato di un pulsante Indietro quando il WebBrowser controllo passa a o lascia l'inizio della cronologia di navigazione.

Vedi anche

• CanGoBackChanged
• GoBack()