WebBrowser.CanGoForward Propriedade

Definição

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

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

Valor da propriedade

true se o controle puder navegar para frente; caso contrário, false.

Atributos

Exemplos

O exemplo de código a seguir demonstra como usar um manipulador para o CanGoForward evento para implementar um botão Encaminhar 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 ButtonForward.

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

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 GoForward método navegará pelo WebBrowser controle para a próxima página neste histórico, se um estiver disponível como resultado de uma navegação anterior com versões anteriores. Se essa propriedade for true, o GoForward método terá êxito. Caso contrário, chamar o GoForward método retornará um valor de false e nenhuma navegação ocorrerá.

Use a propriedade para determinar se o CanGoForward histórico de navegação está disponível e contém uma página localizada após a atual, permitindo que o GoForward método tenha êxito.

Você também pode manipular o CanGoForwardChanged evento para receber uma notificação quando a CanGoForward propriedade for alterada. Lidar com esse evento é útil, por exemplo, para alterar o estado habilitado de um botão Avançar quando o WebBrowser controle navega para ou sai do final do histórico de navegação.

Aplica-se a

Confira também