HtmlWindow.Open Método

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

Retornos

A nova janela ou a janela criada anteriormente nomeada pelo target parâmetro.

Comentários

O target parâmetro pode nomear uma janela que foi criada como resultado de uma chamada anterior para Open. O parâmetro também pode apontar para uma janela aberta clicando em um hiperlink (A elemento) ou em um FORM elemento que usa o TARGET atributo para abrir sua URL em uma nova janela. O código HTML a seguir abrirá uma nova janela nomeada orderWindow quando o usuário clicar nela:

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

Se você fornecer qualquer opção para o windowOptions parâmetro, qualquer opção não incluída será desabilitada automaticamente. Em outras palavras, se você especificar apenas por meio disso, deseja uma barra de windowOptions status, a barra de menus, a barra de ferramentas, o título, as barras de rolagem e assim por diante não serão exibidas, a menos que você as habilite explicitamente por meio de windowOptions.

Se o arquivo referenciado por url for um arquivo HTML, um arquivo de texto ou outro tipo de arquivo que possa ser hospedado dentro de Internet Explorer, ele será exibido na janela nomeada. Se o arquivo não puder ser exibido dentro de Internet Explorer e a janela nomeada pelo destino ainda não existir, a janela será aberta apenas tempo suficiente para Internet Explorer baixar o recurso; ela será fechada imediatamente depois.

Quando você cria novas janelas usando Open ou OpenNew, isso faz com que o Modelo de Objeto de Documento HTML abra uma nova instância de Internet Explorer. Se você não chamar Close em todas as janelas criadas, essa instância de Internet Explorer permanecerá em execução mesmo após a desistência do aplicativo.

Se você usar Open para carregar uma URL em uma janela existente, windowOptions será ignorada; a janela manterá as dimensões, a aparência e a localização da tela primeiro fornecidas pela chamada inicial para Open.

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

Retornos

Uma HtmlWindow janela que representa a nova janela ou a janela criada anteriormente nomeada pelo target parâmetro.

Exemplos

O exemplo de código a seguir contém dois métodos:

• A primeira abre uma URL em uma janela chamada displayWindow, que ela cria com uma barra de status exibida.
• O segundo abre outra URL na mesma janela, mas especifica que apenas a barra de localização deve ser exibida.

Observe que as dimensões da janela e dos controles exibidos dependem de qual URL é aberta primeiro. O exemplo de código requer que seu formulário contenha um WebBrowser controle chamado 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

Comentários

O target parâmetro pode nomear uma janela que foi criada como resultado de uma chamada anterior para Open. O parâmetro também pode apontar para uma janela aberta clicando em um hiperlink (A elemento) ou em um FORM elemento que usa o TARGET atributo para abrir sua URL em uma nova janela. O código HTML a seguir abrirá uma nova janela nomeada orderWindow quando o usuário clicar nela:

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

Se você fornecer qualquer opção para o windowOptions parâmetro, qualquer opção não incluída será desabilitada automaticamente. Em outras palavras, se você especificar apenas por meio disso, deseja uma barra de windowOptions status, a barra de menus, a barra de ferramentas, o título, as barras de rolagem e assim por diante não serão exibidas, a menos que você as habilite explicitamente por meio de windowOptions.

Se o arquivo referenciado por url for um arquivo HTML, um arquivo de texto ou outro tipo de arquivo que possa ser hospedado dentro de Internet Explorer, ele será exibido na janela nomeada. Se o arquivo não puder ser exibido dentro de Internet Explorer e a janela nomeada pelo destino ainda não existir, a janela será aberta apenas tempo suficiente para Internet Explorer baixar o recurso; ela será fechada imediatamente depois.

Quando você cria novas janelas usando Open ou OpenNew, isso faz com que o Modelo de Objeto de Documento HTML abra uma nova instância de Internet Explorer. Se você não chamar Close em todas as janelas criadas, essa instância de Internet Explorer permanecerá em execução mesmo após a desistência do aplicativo.

Se você usar Open para carregar uma URL em uma janela existente, windowOptions será ignorada; a janela manterá as dimensões, a aparência e a localização da tela primeiro fornecidas pela chamada inicial para Open.

Confira também

• método open