HtmlWindow Clase

Definición

Representa la ventana lógica que contiene una o más instancias de HtmlDocument.Represents the logical window that contains one or more instances of HtmlDocument.

public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
Herencia
HtmlWindow

Ejemplos

El siguiente ejemplo de código contiene dos métodos.The following code example contains two methods. La primera abre una dirección URL en una ventana denominada displayWindow , que se crea con una barra de estado mostrada.The first opens a URL in a window named displayWindow, which it creates with a status bar displayed. La segunda abre otra dirección URL en la misma ventana, pero especifica que solo se debe mostrar la barra de ubicación.The second opens another URL in the same window, but specifies that only the location bar should be displayed. Tenga en cuenta que las dimensiones de la ventana y los controles que se muestran dependen de la dirección URL que se abre en primer lugar.Notice that the dimensions of the window and the controls that are displayed depends on which URL is opened first. El ejemplo de código requiere que el formulario contenga un WebBrowser control denominado WebBrowser1 .The code example requires that your form contains a WebBrowser control named 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 se debe confundir con el concepto de una ventana en Windows Forms o la API de Windows; no hay ningún HWND recurso de Windows similar que se corresponda directamente con una instancia de HtmlWindow .HtmlWindow should not be confused with the concept of a window in Windows Forms or the Windows API; there is no HWND or similar Windows resource that corresponds directly to an instance of 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 por medio de mensajes y cuadros de diálogo.Rather, HtmlWindow provides high-level descriptions of a document's location on a user's screen, as well as methods for interacting with users by way of prompts and dialog boxes. 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 capacidades del explorador Web.HtmlWindow acts as a logical container for a Web page's documents and its metadata, such as the document's location and the capabilities of the Web browser.

Una página web está formada por un único documento o un FRAMESET que contiene uno o varios FRAME elementos, cada uno de los cuales hospeda su propio documento.A Web page consists of a single document, or a FRAMESET containing one or more FRAME elements, each of which hosts its own document. Los desarrolladores web utilizan 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).Web developers use framesets to show logically related pages side by side (for example, a content page next to a navigation page). Cuando una página se compone de un único documento, puede tener acceso a ella a través de la Document propiedad de HtmlWindow ; si la página usa marcos, puede tener acceso a sus documentos a través de la Frames colección, que consta de uno o varios HtmlWindow objetos.When a page consists of a single document, you can access it through the Document property of HtmlWindow; if the page uses frames, you can access their documents through the Frames collection, which consists of one or more HtmlWindow objects.

Al hospedar el WebBrowser control en una aplicación Windows Forms, puede elegir interactuar con el usuario mediante clases de Windows Forms estándar, como Form o MessageBox , o puede usar métodos en HtmlWindow definidos para este fin.When your host the WebBrowser control in a Windows Forms application, you can choose to interact with the user using standard Windows Forms classes, such as Form or MessageBox, or you can use methods on HtmlWindow defined for this purpose. El Alert método presenta un sencillo cuadro de diálogo 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 .The Alert method presents a simple dialog box with custom text and an OK button; Prompt presents a line of custom text and a text input field to the user; and Confirm presents a dialog box with a line of custom text and OK and Cancel buttons.

Puede usar HtmlWindow para abrir ventanas nuevas que contienen nuevos documentos.You can use HtmlWindow to open new windows containing new documents. Open carga la dirección URL especificada en la ventana con nombre y la crea si aún no existe, mientras que OpenNew siempre abre su dirección URL en una ventana recién creada.Open loads the specified URL into the named window, creating it if it does not already exist, while OpenNew always opens its URL in a newly created window.

Propiedades

Document

Obtiene el documento HTML incluido en la ventana.Gets the HTML document contained within the window.

DomWindow

Obtiene la interfaz no administrada contenida por esta clase.Gets the unmanaged interface wrapped by this class.

Frames

Obtiene una referencia a cada uno de los elementos FRAME definidos dentro de la página web.Gets a reference to each of the FRAME elements defined within the Web page.

History

Obtiene un objeto que contiene las direcciones URL que el usuario visitó más recientemente.Gets an object containing the user's most recently visited URLs.

IsClosed

Obtiene un valor que indica si esta ventana está abierta o cerrada.Gets a value indicating whether this window is open or closed.

Name

Obtiene o establece el nombre de la ventana.Gets or sets the name of the window.

Opener

Obtiene una referencia a la ventana que abrió la ventana actual.Gets a reference to the window that opened the current window.

Parent

Obtiene la ventana que reside sobre la actual en una página que contiene marcos.Gets the window which resides above the current one in a page containing frames.

Position

Obtiene la posición del área de cliente de la ventana en la pantalla.Gets the position of the window's client area on the screen.

Size

Obtiene o establece el tamaño de la ventana actual.Gets or sets the size of the current window.

StatusBarText

Obtiene o establece el texto mostrado en la barra de estado de una ventana.Gets or sets the text displayed in the status bar of a window.

Url

Obtiene la dirección URL que corresponde al elemento actual mostrado en la ventana.Gets the URL corresponding to the current item displayed in the window.

WindowFrameElement

Obtiene el elemento de marco que corresponde a esta ventana.Gets the frame element corresponding to this window.

Métodos

Alert(String)

Muestra un cuadro de mensaje.Displays a message box.

AttachEventHandler(String, EventHandler)

Agrega un controlador de eventos para el evento de DOM de HTML indicado.Adds an event handler for the named HTML DOM event.

Close()

Cierra la ventana.Closes the window.

Confirm(String)

Muestra un cuadro de diálogo con un mensaje y botones para solicitar una respuesta sí/no.Displays a dialog box with a message and buttons to solicit a yes/no response.

DetachEventHandler(String, EventHandler)

Quita el controlador de eventos con nombre.Removes the named event handler.

Equals(Object)

Prueba el objeto para ver si es igual que el objeto actual.Tests the object for equality against the current object.

Focus()

Coloca el foco en la ventana actual.Puts the focus on the current window.

GetHashCode()

Sirve como función de hash para un tipo concreto.Serves as a hash function for a particular type.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MoveTo(Int32, Int32)

Mueve la ventana a las coordenadas especificadas en la pantalla.Moves the window to the specified coordinates on the screen.

MoveTo(Point)

Mueve la ventana a las coordenadas especificadas en la pantalla.Moves the window to the specified coordinates on the screen.

Navigate(String)

Muestra o descarga el nuevo contenido situado en la dirección URL especificada.Displays or downloads the new content located at the specified URL.

Navigate(Uri)

Muestra un nuevo documento en la ventana actual.Displays a new document in the current window.

Open(String, String, String, Boolean)

Muestra un archivo en la ventana con nombre.Displays a file in the named window.

Open(Uri, String, String, Boolean)

Muestra un archivo en la ventana con nombre.Displays a file in the named window.

OpenNew(String, String)

Muestra un archivo en una ventana nueva.Displays a file in a new window.

OpenNew(Uri, String)

Muestra un archivo en una ventana nueva.Displays a file in a new window.

Prompt(String, String)

Muestra un cuadro de diálogo que presenta un mensaje y un cuadro de texto al usuario.Shows a dialog box that displays a message and a text box to the user.

RemoveFocus()

Quita el foco de la ventana actual.Takes focus off of the current window.

ResizeTo(Int32, Int32)

Cambia el tamaño de la ventana a las dimensiones especificadas.Changes the size of the window to the specified dimensions.

ResizeTo(Size)

Cambia el tamaño de la ventana a las dimensiones especificadas.Changes the size of the window to the specified dimensions.

ScrollTo(Int32, Int32)

Desplaza la ventana a la posición designada.Scrolls the window to the designated position.

ScrollTo(Point)

Desplaza la ventana a las coordenadas especificadas.Moves the window to the specified coordinates.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Operadores

Equality(HtmlWindow, HtmlWindow)

Comprueba si los dos objetos HtmlWindow son iguales.Tests the two HtmlWindow objects for equality.

Inequality(HtmlWindow, HtmlWindow)

Comprueba si dos objetos HtmlWindow no son iguales.Tests two HtmlWindow objects for inequality.

Eventos

Error

Se produce cuando el script que se ejecuta dentro de la ventana encuentra un error en tiempo de ejecución.Occurs when script running inside of the window encounters a run-time error.

GotFocus

Se produce cuando la ventana actual recibe el foco de entrada del usuario.Occurs when the current window obtains user input focus.

Load

Se produce cuando el documento de la ventana y todos sus elementos terminaron de inicializarse.Occurs when the window's document and all of its elements have finished initializing.

LostFocus

Se produce cuando el foco de entrada del usuario sale de la ventana.Occurs when user input focus has left the window.

Resize

Se produce cuando el usuario usa el mouse para cambiar las dimensiones de la ventana.Occurs when the user uses the mouse to change the dimensions of the window.

Scroll

Se produce cuando el usuario se desplaza por la ventana para ver el texto fuera de la pantalla.Occurs when the user scrolls through the window to view off-screen text.

Unload

Se produce cuando la página actual se está descargando y está a punto de mostrarse una nueva página.Occurs when the current page is unloading, and a new page is about to be displayed.

Se aplica a

Consulte también