HtmlWindow Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Herencia

Object

HtmlWindow

Ejemplos

El ejemplo de código siguiente contiene dos métodos. La primera abre una dirección URL en una ventana denominada displayWindow, que crea con una barra de estado mostrada. El segundo abre otra dirección URL en la misma ventana, pero especifica que solo se debe mostrar la barra de ubicación. Observe que las dimensiones de la ventana y los controles que se muestran dependen de la dirección URL que se abra primero. El ejemplo de código requiere que el formulario contenga un WebBrowser control 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);
    }
}

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

Comentarios

HtmlWindow no debe confundirse con el concepto de una ventana en Windows Forms o en la API de Windows; no hay ningún HWND recurso de Windows o similar que corresponda directamente a una instancia de HtmlWindow. En su lugar, HtmlWindow proporciona descripciones de alto nivel de la ubicación de un documento en la pantalla de un usuario, así como métodos para interactuar con los usuarios mediante mensajes y cuadros de diálogo. HtmlWindow actúa como contenedor lógico para los documentos de una página web y sus metadatos, como la ubicación del documento y las funcionalidades del explorador web.

Una página web consta de un único documento o de uno FRAMESET o varios FRAME elementos, cada uno de los cuales hospeda su propio documento. Los desarrolladores web usan conjuntos de marcos para mostrar páginas relacionadas lógicamente en paralelo (por ejemplo, una página de contenido junto a una página de navegación). Cuando una página consta de un único documento, puede acceder a ella a través de la Document propiedad de HtmlWindow; si la página usa marcos, puede acceder a sus documentos a través de la Frames colección, que consta de uno o varios HtmlWindow objetos.

Cuando el control hospeda el WebBrowser control en una aplicación de Windows Forms, puede elegir interactuar con el usuario mediante clases estándar de Windows Forms, como Form o MessageBox, o puede usar métodos en HtmlWindow definidos para este fin. El Alert método presenta un cuadro de diálogo sencillo 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 botones Aceptar y Cancelar .

Puede usar HtmlWindow para abrir nuevas ventanas que contengan nuevos documentos. Open carga la dirección URL especificada en la ventana con nombre, lo crea si aún no existe, mientras OpenNew que siempre abre su dirección URL en una ventana recién creada.

Propiedades

Document	Obtiene el documento HTML incluido en la ventana.
DomWindow	Obtiene la interfaz no administrada contenida por esta clase.
Frames	Obtiene una referencia a cada uno de los FRAME elementos definidos dentro de la página web.
History	Obtiene un objeto que contiene las direcciones URL que el usuario visitó más recientemente.
IsClosed	Obtiene un valor que indica si esta ventana está abierta o cerrada.
Name	Obtiene o establece el nombre de la ventana.
Opener	Obtiene una referencia a la ventana que abrió la ventana actual.
Parent	Obtiene la ventana que reside sobre la actual en una página que contiene marcos.
Position	Obtiene la posición del área de cliente de la ventana en la pantalla.
Size	Obtiene o establece el tamaño de la ventana actual.
StatusBarText	Obtiene o establece el texto mostrado en la barra de estado de una ventana.
Url	Obtiene la dirección URL que corresponde al elemento actual mostrado en la ventana.
WindowFrameElement	Obtiene el elemento de marco que corresponde a esta ventana.

Métodos

Alert(String)	Muestra un cuadro de mensaje.
AttachEventHandler(String, EventHandler)	Agrega un controlador de eventos para el evento de DOM de HTML indicado.
Close()	Cierra la ventana.
Confirm(String)	Muestra un cuadro de diálogo con un mensaje y botones para solicitar una respuesta sí/no.
DetachEventHandler(String, EventHandler)	Quita el controlador de eventos con nombre.
Equals(Object)	Prueba el objeto para ver si es igual que el objeto actual.
Focus()	Coloca el foco en la ventana actual.
GetHashCode()	Sirve como función de hash para un tipo concreto.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MoveTo(Int32, Int32)	Mueve la ventana a las coordenadas especificadas en la pantalla.
MoveTo(Point)	Mueve la ventana a las coordenadas especificadas en la pantalla.
Navigate(String)	Muestra o descarga el nuevo contenido situado en la dirección URL especificada.
Navigate(Uri)	Muestra un nuevo documento en la ventana actual.
Open(String, String, String, Boolean)	Muestra un archivo en la ventana con nombre.
Open(Uri, String, String, Boolean)	Muestra un archivo en la ventana con nombre.
OpenNew(String, String)	Muestra un archivo en una ventana nueva.
OpenNew(Uri, String)	Muestra un archivo en una ventana nueva.
Prompt(String, String)	Muestra un cuadro de diálogo que presenta un mensaje y un cuadro de texto al usuario.
RemoveFocus()	Quita el foco de la ventana actual.
ResizeTo(Int32, Int32)	Cambia el tamaño de la ventana a las dimensiones especificadas.
ResizeTo(Size)	Cambia el tamaño de la ventana a las dimensiones especificadas.
ScrollTo(Int32, Int32)	Desplaza la ventana a la posición designada.
ScrollTo(Point)	Desplaza la ventana a las coordenadas especificadas.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Operadores

Equality(HtmlWindow, HtmlWindow)	Comprueba si los dos objetos HtmlWindow son iguales.
Inequality(HtmlWindow, HtmlWindow)	Comprueba si dos objetos HtmlWindow no son iguales.

Eventos

Error	Se produce cuando el script que se ejecuta dentro de la ventana encuentra un error en tiempo de ejecución.
GotFocus	Se produce cuando la ventana actual recibe el foco de entrada del usuario.
Load	Se produce cuando el documento de la ventana y todos sus elementos terminaron de inicializarse.
LostFocus	Se produce cuando el foco de entrada del usuario sale de la ventana.
Resize	Se produce cuando el usuario usa el mouse para cambiar las dimensiones de la ventana.
Scroll	Se produce cuando el usuario se desplaza por la ventana para ver el texto fuera de la pantalla.
Unload	Se produce cuando la página actual se está descargando y está a punto de mostrarse una nueva página.

Consulte también

• window (objeto)
• IHTMLWindow2 (Interfaz)