Exportar (0) Imprimir
Expandir todo

HtmlWindow (Clase)

Representa la ventana lógica que contiene una o más instancias de HtmlDocument.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public sealed class HtmlWindow
public final class HtmlWindow
public final class HtmlWindow
No aplicable.

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

System.Object
  System.Windows.Forms.HtmlWindow

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2014 Microsoft