WebBrowser.CanGoBack Propriedade

Definição

Obtém um valor que indica se uma página anterior no histórico de navegação está disponível, que permite que o método GoBack() tenha êxito.

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

Valor da propriedade

true se o controle puder navegar de forma regressiva; caso contrário, false.

Atributos

Exemplos

O exemplo de código a seguir demonstra como usar a CanGoBack propriedade para implementar um botão Voltar para o WebBrowser controle semelhante ao da Internet Explorer. Este exemplo exige que o formulário contenha um WebBrowser controle chamado webBrowser1 e um Button controle chamado backButton.

Para obter o exemplo de código completo, consulte 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

Comentários

O WebBrowser controle mantém uma lista de histórico de todas as páginas da Web visitadas durante uma sessão de navegação. O GoBack método navegará pelo WebBrowser controle até a página anterior neste histórico, se houver um disponível. Use a propriedade para determinar se o CanGoBack histórico de navegação está disponível e contém uma página anterior. Se essa propriedade for true, o GoBack método terá êxito. Caso contrário, chamar o GoBack método retornará um valor de false e nenhuma navegação ocorrerá.

Você também pode manipular o CanGoBackChanged evento para receber uma notificação quando a CanGoBack propriedade for alterada. A manipulação desse evento é útil, por exemplo, para alterar o estado habilitado de um botão Voltar quando o WebBrowser controle navega ou sai do início do histórico de navegação.

Aplica-se a

Confira também