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

Métodos

Operadores

Eventos

Aplica-se a

Confira também

• Objeto window
• IHTMLWindow2 Interface