HtmlWindow Classe

Definição

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Herança

Object

HtmlWindow

Exemplos

O seguinte exemplo de código contém dois métodos. O primeiro abre uma URL numa janela chamada displayWindow, que cria com uma barra de estado exibida. O segundo abre outro URL na mesma janela, mas especifica que apenas a barra de localização deve ser exibida. Note que as dimensões da janela e os controlos que são exibidos dependem de qual URL é aberta primeiro. O exemplo do código exige que o seu formulário contenha um WebBrowser controlo 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

Observações

HtmlWindow não deve ser confundido com o conceito de janela em Windows Forms ou na API Windows; não existe HWND ou recurso Windows semelhante que corresponda diretamente a uma instância de HtmlWindow. Em vez disso, HtmlWindow fornece descrições de alto nível da localização de um documento no ecrã do utilizador, bem como métodos para interagir com os utilizadores através de prompts e caixas de diálogo. HtmlWindow atua como um contentor lógico para os documentos de uma página Web e os seus metadados, como a localização do documento e as capacidades do navegador Web.

Uma página Web consiste num único documento, ou FRAMESET num que contém um ou mais FRAME elementos, cada um dos quais hospeda o seu próprio documento. Os programadores web usam framesets 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 num único documento, pode aceder a ela através da Document propriedade de HtmlWindow; se a página usar molduras, pode aceder aos seus documentos através da Frames coleção, que consiste em um ou mais HtmlWindow objetos.

Quando o seu host controla o WebBrowser numa aplicação Windows Forms, pode optar por interagir com o utilizador usando classes Windows Forms padrão, como Form ou MessageBox, ou pode usar métodos em HtmlWindow definidos para esse fim. 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 introdução de texto ao utilizador; e Confirm apresenta uma caixa de diálogo com uma linha de texto personalizado e os botões OK e Cancelar .

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

Ver também

• Objeto janela
• IHTMLWindow2 Interface