Compartilhar via


HtmlWindow Classe

Definição

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
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.

Aplica-se a

Confira também