Visão geral do controle WebBrowser

  • Artigo

O WebBrowser controle fornece um wrapper gerenciado para o controle ActiveX WebBrowser. O wrapper gerenciado permite exibir páginas da Web em seus aplicativos cliente dos Windows Forms. Você pode usar o controle para duplicar a funcionalidade de navegação na Web do Internet Explorer em seu aplicativo ou você pode desabilitar a funcionalidade padrão do Internet Explorer e usar o WebBrowser controle como um visualizador de documentos HTML simples. Você também pode usar o controle para adicionar elementos de interface do usuário baseados em DHTML ao seu formulário e ocultar o fato de que eles estão hospedados no WebBrowser controle. Essa abordagem permite combinar perfeitamente controles Web com controles dos Windows Forms em um único aplicativo.

Propriedades, métodos e eventos usados com frequência

O WebBrowser controle tem várias propriedades, métodos e eventos que você pode usar para implementar controles encontrados no Internet Explorer. Por exemplo, você pode usar o método Navigate para implementar uma barra de endereços e os métodos GoBack, GoForward, Stop e Refresh para implementar os botões de navegação em uma barra de ferramentas. Você pode manipular o evento Navigated para atualizar a barra de endereços com o valor da propriedade Url e a barra de título com o valor da propriedade DocumentTitle.

Se você quiser gerar seu próprio conteúdo de página dentro de seu aplicativo, defina a propriedade DocumentText. Se você estiver familiarizado com o DOM (Modelo de Objeto do Documento) HTML, também poderá manipular o conteúdo da página da Web por meio da propriedade Document. Com essa propriedade, você pode armazenar e modificar documentos na memória, em vez de navegar entre arquivos.

A propriedade Document também permite que você chame os métodos implementados no código de script da página da Web do seu código de aplicativo cliente. Para acessar o código do aplicativo cliente do seu código de script, defina a propriedade ObjectForScripting. O objeto especificado pode ser acessado pelo seu código de script como o objeto window.external.

Nome Descrição
Propriedade Document Obtém um objeto que fornece acesso gerenciado para DOM (Modelo de Objeto do Documento) HTML da página da Web atual.
Evento DocumentCompleted Ocorre quando uma página da Web conclui o carregamento.
Propriedade DocumentText Obtém ou define o conteúdo HTML da página da Web atual.
Propriedade DocumentTitle Obtém o título da página da Web atual.
Método GoBack Navega para a página anterior no histórico.
Método GoForward Navega para a próxima página no histórico.
Método Navigate Navega para a URL especificada.
Evento Navigating Ocorre antes do início de navegação, permitindo que a ação seja cancelada.
Propriedade ObjectForScripting Obtém ou define um objeto que o código de script da página da Web pode usar para se comunicar com o aplicativo.
Método Print Imprime a página da Web atual.
Método Refresh Recarrega a página da Web atual.
Método Stop Interrompe a navegação atual e para elementos de página dinâmicos, como sons e animação.
Propriedade Url Obtém ou define a URL da página da Web atual. Configurar essa propriedade leva o controle para a nova URL.

Confira também