Partilhar via

Visão geral do controle WebBrowser

  • Artigo

O controle WebBrowser fornece um wrapper gerenciado para o controle ActiveX WebBrowser. O wrapper gerenciado permite que você exiba 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 pode 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 da Web com controles do Windows Forms em um único aplicativo.

Propriedades, métodos e eventos usados com freqüê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 manipular o evento Navigated para atualizar a barra de endereço 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, você pode definir a propriedade DocumentText. Se você estiver familiarizado com o modelo de objeto de documento HTML (DOM), você também pode manipular o conteúdo da página da Web atual através 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 chamar métodos implementados no código de script de página da Web a partir do código do aplicativo cliente. Para acessar o código do aplicativo cliente a partir do código de script, defina a propriedade ObjectForScripting. O objeto especificado pode ser acessado pelo código de script como o objeto window.external.

Nome Descrição
Document propriedade Obtém um objeto que fornece acesso gerenciado ao modelo de objeto de documento HTML (DOM) da página da Web atual.
evento DocumentCompleted Ocorre quando uma página da Web termina de carregar.
DocumentText propriedade Obtém ou define o conteúdo HTML da página da Web atual.
DocumentTitle propriedade Obtém o título da página da Web atual.
Método GoBack Navega para a página anterior na história.
Método GoForward Navega para a próxima página da história.
Método Navigate Navega até o URL especificado.
Navigating evento Ocorre antes do início da navegação, permitindo que a ação seja cancelada.
ObjectForScripting propriedade 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.
Url propriedade Obtém ou define a URL da página da Web atual. A definição desta propriedade navega o controlo para o novo endereço URL.

Ver também