HtmlWindow.Open Método

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

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

Devoluções

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

Observações

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

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

Se forneceres alguma opção para o windowOptions parâmetro, qualquer opção não incluída fica automaticamente desativada. Ou seja, se só especificar windowOptions por meio de que quer uma barra de estado, então a barra de menus, barra de ferramentas, título, barras de scroll, etc., não serão exibidos a menos que os ative explicitamente através de windowOptions.

Se o ficheiro referenciado por url for um ficheiro HTML, um ficheiro de texto ou outro tipo de ficheiro que pode ser alojado dentro de Internet Explorer, será exibido na janela nomeada. Se o ficheiro não puder ser exibido dentro do Internet Explorer, e a janela nomeada pelo alvo ainda não existir, então a janela abrirá apenas o tempo suficiente para o Internet Explorer descarregar o recurso; fechará imediatamente a seguir.

Quando crias novas janelas usando Open ou OpenNew, isso faz com que o Modelo de Objetos do Documento HTML abra uma nova instância de Internet Explorer. Se não chamar Close em todas as janelas que criou, esta instância de Internet Explorer continuará a funcionar mesmo depois de a sua aplicação ter sido encerrada.

Se usar Open para carregar uma URL numa janela existente, windowOptions será ignorado; a janela manterá primeiro as dimensões, aparência e localização do ecrã dadas pela chamada inicial para Open.

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

Origem:

HtmlWindow.cs

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

Devoluções

Um HtmlWindow representa a nova janela, ou a janela previamente criada nomeada pelo target parâmetro.

Exemplos

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

• O primeiro abre uma URL numa janela chamada displayWindow, que cria com uma barra de estado exibida.
• O segundo abre outro URL na mesma janela, mas especifica que apenas a barra de localização deve ser exibida.

Note que as dimensões da janela e os controlos que são exibidos dependem de qual URL é aberta primeiro. O exemplo do código exige que o seu formulário contenha um WebBrowser controlo 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

Observações

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

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

Se forneceres alguma opção para o windowOptions parâmetro, qualquer opção não incluída fica automaticamente desativada. Ou seja, se só especificar windowOptions por meio de que quer uma barra de estado, então a barra de menus, barra de ferramentas, título, barras de scroll, etc., não serão exibidos a menos que os ative explicitamente através de windowOptions.

Se o ficheiro referenciado por url for um ficheiro HTML, um ficheiro de texto ou outro tipo de ficheiro que pode ser alojado dentro de Internet Explorer, será exibido na janela nomeada. Se o ficheiro não puder ser exibido dentro do Internet Explorer, e a janela nomeada pelo alvo ainda não existir, então a janela abrirá apenas o tempo suficiente para o Internet Explorer descarregar o recurso; fechará imediatamente a seguir.

Quando crias novas janelas usando Open ou OpenNew, isso faz com que o Modelo de Objetos do Documento HTML abra uma nova instância de Internet Explorer. Se não chamar Close em todas as janelas que criou, esta instância de Internet Explorer continuará a funcionar mesmo depois de a sua aplicação ter sido encerrada.

Se usar Open para carregar uma URL numa janela existente, windowOptions será ignorado; a janela manterá primeiro as dimensões, aparência e localização do ecrã dadas pela chamada inicial para Open.

Ver também

• Método aberto