HtmlWindow no se debe confundir con el concepto de una ventana de formularios Windows Forms o la API Win32; no hay ningún HWND ni ningún recurso similar de Windows que se corresponda directamente con una instancia de HtmlWindow. Más bien, HtmlWindow proporciona descripciones de alto nivel de la ubicación de un documento en la pantalla de un usuario, así como los métodos para interactuar con los usuarios por medio de preguntas y cuadros de diálogo. HtmlWindow actúa como un contenedor lógico para los documentos de una página Web y sus metadatos, como la ubicación del documento y las funciones del explorador web.

Una página Web está compuesta por un documento único o un FRAMESET que contiene uno o más elementos FRAME, cada uno de los cuales aloja su propio documento. Los desarrolladores Web utilizan conjuntos de marcos para mostrar una junto a otra las páginas relacionadas de forma lógica (por ejemplo, una página de contenido junto a una página de navegación). Cuando una página consta de un único documento, se puede tener acceso a ella a través de la propiedad Document de HtmlWindow; si la página utiliza marcos, puede tener acceso a sus documentos a través de la colección Frames, que está compuesta por uno o más objetos HtmlWindow.

Cuando aloja el control WebBrowser en una aplicación de Windows Forms, puede optar por interactuar con el usuario utilizando las clases estándar de los formularios Windows Forms, como Form o MessageBox, o puede utilizar los métodos de la clase HtmlWindow definidos para este propósito. El método Alert presenta un cuadro de diálogo simple con texto personalizado y un botón Aceptar; Prompt presenta una línea de texto personalizado y un campo de entrada de texto al usuario; y Confirm presenta un cuadro de diálogo con una línea de texto personalizado y los botones Aceptar y Cancelar.

Puede utilizar HtmlWindow para abrir nuevas ventanas que contengan los documentos nuevos. Open carga la dirección URL especificada en la ventana con nombre, creándola si no existe todavía, mientras que OpenNew siempre abre su dirección URL en una ventana recientemente creada.

El ejemplo de código siguiente contiene dos métodos. El primero abre una dirección URL en una ventana denominada displayWindow, que este método crea y en la que se muestra una barra de estado. El segundo abre otra dirección URL en la misma ventana, pero especifica que sólo se debería mostrar la barra de situación. Tenga en cuenta que las dimensiones de la ventana y los controles que se muestran dependen de qué dirección URL se abre en primer lugar. El ejemplo de código requiere que el formulario contenga un control WebBrowser denominado WebBrowser1.

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

        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);
            }
        }

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referencia

Otros recursos