WebBrowser.CanGoForward Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.