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);

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 chamada 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 chamada 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 dissowindowOptions, deseja uma barra de 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 da Internet Explorer, ele será exibido na janela nomeada. Se o arquivo não puder ser exibido dentro do Explorer da Internet e a janela nomeada por destino ainda não existir, a janela será aberta apenas por tempo suficiente para que Explorer da Internet baixem o recurso; ele será fechado 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 Explorer da Internet. Se você não chamar Close em todas as janelas que criou, essa instância do Explorer da Internet permanecerá em execução mesmo após o encerramento 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 o local da tela primeiro, considerando-a 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);

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

Um HtmlWindow que representa a nova janela ou a janela criada anteriormente chamada pelo parâmetro target.

Exemplos

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

• O primeiro 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 os 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 chamada 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 dissowindowOptions, deseja uma barra de 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 da Internet Explorer, ele será exibido na janela nomeada. Se o arquivo não puder ser exibido dentro do Explorer da Internet e a janela nomeada por destino ainda não existir, a janela será aberta apenas por tempo suficiente para que Explorer da Internet baixem o recurso; ele será fechado 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 Explorer da Internet. Se você não chamar Close em todas as janelas que criou, essa instância do Explorer da Internet permanecerá em execução mesmo após o encerramento 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 o local da tela primeiro, considerando-a pela chamada inicial para Open.

Confira também

• Método open