Compartilhar via

Visão geral do controle WebBrowser

  • Artigo

O controle WebBrowser fornece um wrapper gerenciado para o controle ActiveX do WebBrowser. O wrapper gerenciado permite exibir páginas da Web em seus aplicativos cliente do Windows Forms. Você pode usar o controle WebBrowser para duplicar a funcionalidade de navegação na Web do Internet Explorer em seu aplicativo ou desabilitar a funcionalidade padrão do Internet Explorer e usar o 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 controle WebBrowser. Essa abordagem permite combinar perfeitamente controles Web com controles do Windows Forms em um único aplicativo.

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

O controle WebBrowser 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, Stope Refresh para implementar botões de navegação em uma barra de ferramentas. Você pode lidar com 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 em seu aplicativo, poderá definir a propriedade DocumentText. Se você estiver familiarizado com o DOM (modelo de objeto de documento HTML), também poderá manipular o conteúdo da página da Web atual 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 a partir do código de script, defina a propriedade ObjectForScripting. O objeto que você especificar pode ser acessado pelo código de script como o objeto window.external.

Nome Descrição
Propriedade Document Obtém um objeto que fornece acesso gerenciado ao DOM (modelo de objeto de documento HTML) da página da Web atual.
Evento DocumentCompleted Ocorre quando uma página da Web termina de carregar.
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 até a URL especificada.
Evento Navigating Ocorre antes do início da navegação, permitindo que a ação seja cancelada.
Propriedade ObjectForScripting Obtém ou define um objeto que o código de script de página da Web pode usar para se comunicar com seu 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 interrompe elementos dinâmicos da página, como sons e animação.
Propriedade Url Obtém ou define a URL da página da Web atual. Ajustar essa propriedade faz com que o controle navegue para o novo URL.

Consulte também