HtmlWindow.Open Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Muestra un archivo en la ventana con nombre.

Sobrecargas

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.

Open(String, String, String, Boolean)

Muestra un archivo en la ventana con nombre.

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (string urlString, string target, string windowOptions, bool replaceEntry);

member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parámetros

urlString

String

Localizador uniforme de recursos que describe la ubicación del archivo que se va a cargar.

target

String

Nombre de la ventana en la que se va a abrir el recurso. Puede ser un nombre proporcionado por el desarrollador o uno de los valores especiales siguientes:

_blank: se abre urlString en una nueva ventana. Funciona igual que una llamada a OpenNew(String, String).

_media: se abre urlString en la barra Multimedia.

_parent: se abre urlString en la ventana que creó la ventana actual.

_search: se abre urlString en la barra de búsqueda.

_self: se abre urlString en la ventana actual.

_top: si se llama a en una ventana que pertenece a un FRAME elemento , se abre urlString en la ventana que hospeda su FRAMESET. De lo contrario, actúa igual que _self.

windowOptions

String

Cadena delimitada por comas que consta de cero o más de las siguientes opciones con el formato name=value. Excepto para las leftopciones , top, heighty width , que toman enteros arbitrarios, cada opción acepta o , 1y no o 0, como valores válidosyes.

channelmode: se usa con la tecnología de canales en desuso de Internet Explorer 4.0. El valor predeterminado es no.

directories: indica si la ventana debe mostrar los botones de navegación del directorio. El valor predeterminado es yes.

height: el alto del área cliente de la ventana, en píxeles. El mínimo es 100; si se intenta abrir una ventana de un tamaño inferior, la ventana se abrirá según los valores predeterminados de Internet Explorer.

left: la posición izquierda (coordenada X) de la ventana con relación a la esquina superior izquierda de la pantalla del usuario, en píxeles. Debe ser un entero positivo.

location: indica si se va a mostrar la barra de direcciones, lo que permite a los usuarios navegar por la ventana a una nueva dirección URL. El valor predeterminado es yes.

menubar: determina si se deben mostrar o los menús en la nueva ventana. El valor predeterminado es yes.

resizable: determina si el usuario puede cambiar el tamaño de la ventana. El valor predeterminado es yes.

scrollbars: indica si la ventana tiene barras de desplazamiento horizontales y verticales. El valor predeterminado es yes.

status: indica si la ventana tiene una barra de estado en la parte inferior. El valor predeterminado es yes.

titlebar: indica si se muestra el título de la página actual. Establecer esta opción no en no tiene ningún efecto dentro de una aplicación administrada; la barra de título siempre aparecerá.

toolbar: indica si los botones de la barra de herramientas como Atrás, Adelante y Detener están visibles. El valor predeterminado es yes.

top: posición superior (coordenada y) de la ventana, en relación con la esquina superior izquierda de la pantalla del usuario, en píxeles. Debe ser un entero positivo.

width: ancho del área cliente de la ventana, en píxeles. El mínimo es 100; si se intenta abrir una ventana de un tamaño inferior, la ventana se abrirá según los valores predeterminados de Internet Explorer.

replaceEntry

Boolean

true para reemplazar la dirección URL de la ventana actual por urlString en el historial de navegación. Afectará al funcionamiento de los métodos de la clase HtmlHistory.

Devoluciones

HtmlWindow

Nueva ventana o la ventana creada anteriormente denominada por el target parámetro .

Comentarios

El target parámetro puede asignar un nombre a una ventana que se creó como resultado de una llamada anterior a Open. El parámetro también puede apuntar a una ventana abierta haciendo clic en un hipervínculo (A elemento) o en un FORM elemento que usa el TARGET atributo para abrir su dirección URL en una nueva ventana. El código HTML siguiente abrirá una nueva ventana denominada orderWindow cuando el usuario haga clic en ella:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Si proporciona alguna opción para el windowOptions parámetro , cualquier opción no incluida se deshabilita automáticamente. En otras palabras, si solo especifica por medio de que desea una barra de estado, la barra de windowOptions menús, la barra de herramientas, el título, las barras de desplazamiento, etc. no se mostrarán a menos que las habilite explícitamente a modo de windowOptions.

Si el archivo al que hace url referencia es un archivo HTML, un archivo de texto u otro tipo de archivo que se puede hospedar dentro de Internet Explorer, se mostrará en la ventana con nombre. Si el archivo no se puede mostrar dentro de Internet Explorer y la ventana denominada por destino aún no existe, la ventana solo se abrirá lo suficiente para que Internet Explorer descargue el recurso; se cerrará inmediatamente después.

Al crear nuevas ventanas con Open o OpenNew, hace que el modelo de objetos de documento HTML abra una nueva instancia de Internet Explorer. Si no llama a Close en todas las ventanas que ha creado, esta instancia de Internet Explorer permanecerá en ejecución incluso después de que la aplicación se haya dejado de ejecutar.

Si usa Open para cargar una dirección URL en una ventana existente, windowOptions se omitirá; la ventana conservará primero las dimensiones, la apariencia y la ubicación de la pantalla dadas por la llamada inicial a Open.

Open(Uri, String, String, Boolean)

Muestra un archivo en la ventana con nombre.

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (Uri url, string target, string windowOptions, bool replaceEntry);

member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parámetros

url

Uri

Localizador uniforme de recursos que describe la ubicación del archivo que se va a cargar.

target

String

Nombre de la ventana en la que se va a abrir el recurso. Puede ser un nombre proporcionado por el desarrollador o uno de los valores especiales siguientes:

_blank: se abre url en una nueva ventana. Funciona igual que una llamada a OpenNew(String, String).

_media: se abre url en la barra Multimedia.

_parent: se abre url en la ventana que creó la ventana actual.

_search: se abre url en la barra de búsqueda.

_self: se abre url en la ventana actual.

_top: si se llama a en una ventana que pertenece a un FRAME elemento , se abre url en la ventana que hospeda su FRAMESET. De lo contrario, actúa igual que _self.

windowOptions

String

Cadena delimitada por comas que consta de cero o más de las siguientes opciones con el formato name=value. Excepto para las leftopciones , top, heighty width , que toman enteros arbitrarios, cada opción acepta o , 1y no o 0, como valores válidosyes.

channelmode: se usa con la tecnología de canales en desuso de Internet Explorer 4.0. El valor predeterminado es no.

directories: indica si la ventana debe mostrar los botones de navegación del directorio. El valor predeterminado es yes.

height: el alto del área cliente de la ventana, en píxeles. El mínimo es 100; si se intenta abrir una ventana de un tamaño inferior, la ventana se abrirá según los valores predeterminados de Internet Explorer.

left: la posición izquierda (coordenada X) de la ventana con relación a la esquina superior izquierda de la pantalla del usuario, en píxeles. Debe ser un entero positivo.

location: indica si se va a mostrar la barra de direcciones, lo que permite a los usuarios navegar por la ventana a una nueva dirección URL. El valor predeterminado es yes.

menubar: determina si se deben mostrar o los menús en la nueva ventana. El valor predeterminado es yes.

resizable: determina si el usuario puede cambiar el tamaño de la ventana. El valor predeterminado es yes.

scrollbars: indica si la ventana tiene barras de desplazamiento horizontales y verticales. El valor predeterminado es yes.

status: indica si la ventana tiene una barra de estado en la parte inferior. El valor predeterminado es yes.

titlebar: indica si se muestra el título de la página actual. Establecer esta opción no en no tiene ningún efecto dentro de una aplicación administrada; la barra de título siempre aparecerá.

toolbar: indica si los botones de la barra de herramientas como Atrás, Adelante y Detener están visibles. El valor predeterminado es yes.

top: posición superior (coordenada y) de la ventana, relativa a la esquina superior izquierda de la pantalla del usuario, en píxeles. Debe ser un entero positivo.

width: ancho del área de cliente de la ventana, en píxeles. El mínimo es 100; si se intenta abrir una ventana de un tamaño inferior, la ventana se abrirá según los valores predeterminados de Internet Explorer.

replaceEntry

Boolean

true para reemplazar la dirección URL de la ventana actual por url en el historial de navegación. Esto afectará al funcionamiento de los métodos en la HtmlHistory clase .

Devoluciones

HtmlWindow

HtmlWindow que representa la nueva ventana o la ventana previamente creada denominada por el parámetro target.

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

El target parámetro puede asignar un nombre a una ventana que se creó como resultado de una llamada anterior a Open. El parámetro también puede apuntar a una ventana abierta haciendo clic en un hipervínculo (A elemento) o en un FORM elemento que usa el TARGET atributo para abrir su dirección URL en una nueva ventana. El código HTML siguiente abrirá una nueva ventana denominada orderWindow cuando el usuario haga clic en él:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Si proporciona alguna opción para el windowOptions parámetro , cualquier opción no incluida se deshabilita automáticamente. En otras palabras, si solo especifica por medio de que desea una barra de windowOptions estado, la barra de menús, la barra de herramientas, el título, las barras de desplazamiento, etc., no se mostrará a menos que las habilite explícitamente mediante windowOptions.

Si el archivo al url que hace referencia es un archivo HTML, un archivo de texto u otro tipo de archivo que se puede hospedar dentro de Internet Explorer, se mostrará en la ventana con nombre. Si el archivo no se puede mostrar dentro de Internet Explorer y la ventana denominada por destino aún no existe, la ventana solo se abrirá lo suficiente para que Internet Explorer descargue el recurso; se cerrará inmediatamente después.

Al crear nuevas ventanas con Open o OpenNew, hace que el modelo de objetos de documento HTML abra una nueva instancia de Internet Explorer. Si no llama a Close en todas las ventanas que ha creado, esta instancia de Internet Explorer seguirá ejecutándose incluso después de que la aplicación se haya terminado.

Si usa Open para cargar una dirección URL en una ventana existente, windowOptions se omitirá; la ventana conservará las dimensiones, la apariencia y la ubicación de la pantalla en primer lugar dada por la llamada inicial a Open.

Consulte también

• open (método)