HtmlWindow Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa a janela lógica que contém uma ou mais instâncias de HtmlDocument.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Herança

Object

HtmlWindow

Exemplos

O exemplo de código a seguir contém dois métodos. O primeiro abre uma URL em uma janela chamada displayWindow, que ela cria com uma barra de status exibida. O segundo abre outra URL na mesma janela, mas especifica que apenas a barra de localização deve ser exibida. Observe que as dimensões da janela e os controles exibidos dependem de qual URL é aberta primeiro. O exemplo de código requer que seu formulário contenha um WebBrowser controle chamado WebBrowser1.

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

Comentários

HtmlWindow não deve ser confundido com o conceito de uma janela no Windows Forms ou com a API do Windows; não há nenhum HWND recurso do Windows ou semelhante que corresponda diretamente a uma instância do HtmlWindow. Em vez disso, HtmlWindow fornece descrições de alto nível da localização de um documento na tela de um usuário, bem como métodos para interagir com os usuários por meio de prompts e caixas de diálogo. HtmlWindow atua como um contêiner lógico para documentos de uma página da Web e seus metadados, como a localização do documento e os recursos do navegador da Web.

Uma página da Web consiste em um único documento ou um que contém um ou mais FRAME elementos, cada um FRAMESET dos quais hospeda seu próprio documento. Os desenvolvedores da Web usam conjuntos de quadros para mostrar páginas logicamente relacionadas lado a lado (por exemplo, uma página de conteúdo ao lado de uma página de navegação). Quando uma página consiste em um único documento, você pode acessá-la por meio da Document propriedade de HtmlWindow; se a página usa quadros, você pode acessar seus documentos por meio da Frames coleção, que consiste em um ou mais HtmlWindow objetos.

Ao hospedar o WebBrowser controle em um aplicativo do Windows Forms, você pode optar por interagir com o usuário usando classes padrão do Windows Forms, como Form ou MessageBox, ou pode usar métodos definidos HtmlWindow para essa finalidade. O Alert método apresenta uma caixa de diálogo simples com texto personalizado e um botão OK ; Prompt apresenta uma linha de texto personalizado e um campo de entrada de texto para o usuário e Confirm apresenta uma caixa de diálogo com uma linha de texto personalizado e botões OK e Cancelar .

Você pode usar HtmlWindow para abrir novas janelas que contêm novos documentos. Open carrega a URL especificada na janela nomeada, criando-a se ela ainda não existir, enquanto OpenNew sempre abre sua URL em uma janela recém-criada.

Propriedades

Document	Obtém o documento HTML contido dentro da janela.
DomWindow	Obtém a interface não gerenciada encapsulada por essa classe.
Frames	Obtém uma referência a cada um dos elementos FRAME definidos na página da Web.
History	Obtém um objeto que contém as URLs mais visitadas do usuário.
IsClosed	Obtém um valor que indica se esta janela está aberta ou fechada.
Name	Obtém ou define o nome da janela.
Opener	Obtém uma referência para a janela que abriu a janela atual.
Parent	Obtém a janela que está acima da atual em uma página que contém quadros.
Position	Obtém a posição da área de cliente da janela na tela.
Size	Obtém ou define o tamanho da janela atual.
StatusBarText	Obtém ou define o texto exibido na barra de status de uma janela.
Url	Obtém a URL correspondente ao item atual exibido na janela.
WindowFrameElement	Obtém o elemento de quadro correspondente a essa janela.

Métodos

Alert(String)	Exibe uma caixa de mensagem.
AttachEventHandler(String, EventHandler)	Adiciona um manipulador de eventos para o evento HTML DOM nomeado.
Close()	Fecha a janela.
Confirm(String)	Exibe uma caixa de diálogo com uma mensagem e botões para solicitar uma resposta sim/não.
DetachEventHandler(String, EventHandler)	Remove o manipulador de eventos nomeado.
Equals(Object)	Testa o objeto quanto a igualdade em relação ao objeto atual.
Focus()	Coloca o foco na janela atual.
GetHashCode()	Serve como uma função hash para um tipo particular.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MoveTo(Int32, Int32)	Move a janela para as coordenadas especificadas na tela.
MoveTo(Point)	Move a janela para as coordenadas especificadas na tela.
Navigate(String)	Exibe ou baixa o novo conteúdo localizado na URL especificada.
Navigate(Uri)	Exibe um novo documento na janela atual.
Open(String, String, String, Boolean)	Exibe um arquivo na janela nomeada.
Open(Uri, String, String, Boolean)	Exibe um arquivo na janela nomeada.
OpenNew(String, String)	Exibe um arquivo em uma nova janela.
OpenNew(Uri, String)	Exibe um arquivo em uma nova janela.
Prompt(String, String)	Mostra uma caixa de diálogo que exibe uma mensagem e uma caixa de texto ao usuário.
RemoveFocus()	Tira o foco da janela atual.
ResizeTo(Int32, Int32)	Altera o tamanho da janela para as dimensões especificadas.
ResizeTo(Size)	Altera o tamanho da janela para as dimensões especificadas.
ScrollTo(Int32, Int32)	Role a janela para a posição designada.
ScrollTo(Point)	Move a janela para as coordenadas especificadas.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Operadores

Equality(HtmlWindow, HtmlWindow)	Testa os dois objetos HtmlWindow quanto à igualdade.
Inequality(HtmlWindow, HtmlWindow)	Testa dois objetos HtmlWindow quanto à desigualdade.

Eventos

Error	Ocorre quando o script em execução dentro da janela encontra um erro em tempo de execução.
GotFocus	Ocorre quando a janela atual obtém o foco de entrada do usuário.
Load	Ocorre quando a inicialização do documento da janela e de todos os seus elementos foi concluída.
LostFocus	Ocorre quando o foco de entrada do usuário saiu da janela.
Resize	Ocorre quando o usuário usa o mouse para alterar as dimensões da janela.
Scroll	Ocorre quando o usuário rola pela janela para exibir o texto fora da tela.
Unload	Ocorre quando a página atual está descarregando e uma nova página está prestes a ser exibida.

Confira também

• Objeto window
• IHTMLWindow2 Interface