HtmlWindow.Open Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Exibe um arquivo na janela nomeada.

Sobrecargas

Open(String, String, String, Boolean)

Exibe um arquivo na janela nomeada.
Open(Uri, String, String, Boolean)

Exibe um arquivo na janela nomeada.

Open(String, String, String, Boolean)

Exibe um arquivo na janela nomeada.

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

urlString
String

URL (Uniform Resource Locator) que descreve o local do arquivo a ser carregado.

target
String

O nome da janela na qual abrir o recurso. Pode ser um nome fornecido pelo desenvolvedor ou um dos seguintes valores especiais:

_blank: abre urlString em uma nova janela. Funciona da mesma forma que uma chamada para OpenNew(String, String).

_media: abre urlString na barra Mídia.

_parent: abre urlString na janela que criou a janela atual.

_search: abre urlString na barra de pesquisa.

_self: abre urlString na janela atual.

_top: se chamado em uma janela que pertence a um elemento FRAME , abrirá urlString na janela que hospeda seu FRAMESET. Caso contrário, age igual a _self.

windowOptions
String

Uma cadeia de caracteres delimitada por vírgula que consiste em zero ou mais das seguintes opções no formulário name=value. Exceto para as opções left, top, height e width, que recebem inteiros arbitrários, cada opção aceita yes ou 1 e no ou 0 como os valores válidos.

channelmode: usado com a tecnologia de canais preteridos do Internet Explorer 4.0. O padrão é no.

directories: caso a janela deva exibir botões de navegação de diretório. O padrão é yes.

height: a altura da área de cliente da janela, em pixels. O mínimo é de 100; tentativas de abrir uma janela menor do que isso fará a janela ser aberta conforme os padrões do Internet Explorer.

left: a posição (coordenada X) esquerda da janela em relação ao canto superior esquerdo da tela do usuário, em pixels. Deve ser um número inteiro positivo.

location: se desejar exibir a barra de endereços, que permite aos usuários navegar a janela para uma nova URL. O padrão é yes.

menubar: se desejar exibir menus na nova janela. O padrão é yes.

resizable: se a janela puder ser redimensionada pelo usuário. O padrão é yes.

scrollbars: se a janela tiver barras de rolagem horizontais e verticais. O padrão é yes.

status: se a janela tiver uma barra de status na parte inferior. O padrão é yes.

titlebar: se o título da página atual for exibido. Definir essa opção como no não tem efeito em um aplicativo gerenciado; a barra de título sempre aparecerá.

toolbar: se os botões da barra de ferramentas como Voltar, Avançar, e Parar estiverem visíveis. O padrão é yes.

top: a posição (coordenada y) superior da janela em relação ao canto superior esquerdo da tela do usuário, em pixels. Deve ser um número inteiro positivo.

width: a largura da área de cliente da janela, em pixels. O mínimo é de 100; tentativas de abrir uma janela menor do que isso fará a janela ser aberta conforme os padrões do Internet Explorer.

replaceEntry
Boolean

true para substituir a URL da janela atual pelo urlString no histórico de navegação. Isso afetará a operação dos métodos da classe HtmlHistory.

Retornos

HtmlWindow

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.

Aplica-se a

Open(Uri, String, String, Boolean)

Exibe um arquivo na janela nomeada.

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

url
Uri

URL (Uniform Resource Locator) que descreve o local do arquivo a ser carregado.

target
String

O nome da janela na qual abrir o recurso. Pode ser um nome fornecido pelo desenvolvedor ou um dos seguintes valores especiais:

_blank: abre url em uma nova janela. Funciona da mesma forma que uma chamada para OpenNew(String, String).

_media: abre url na barra Mídia.

_parent: abre url na janela que criou a janela atual.

_search: abre url na barra de pesquisa.

_self: abre url na janela atual.

_top: se chamado em uma janela que pertence a um elemento FRAME , abrirá url na janela que hospeda seu FRAMESET. Caso contrário, age igual a _self.

windowOptions
String

Uma cadeia de caracteres delimitada por vírgula que consiste em zero ou mais das seguintes opções no formulário name=value. Exceto para as opções left, top, height e width, que recebem inteiros arbitrários, cada opção aceita yes ou 1 e no ou 0 como os valores válidos.

channelmode: usado com a tecnologia de canais preteridos do Internet Explorer 4.0. O padrão é no.

directories: caso a janela deva exibir botões de navegação de diretório. O padrão é yes.

height: a altura da área de cliente da janela, em pixels. O mínimo é de 100; tentativas de abrir uma janela menor do que isso fará a janela ser aberta conforme os padrões do Internet Explorer.

left: a posição (coordenada X) esquerda da janela em relação ao canto superior esquerdo da tela do usuário, em pixels. Deve ser um número inteiro positivo.

location: se desejar exibir a barra de endereços, que permite aos usuários navegar a janela para uma nova URL. O padrão é yes.

menubar: se desejar exibir menus na nova janela. O padrão é yes.

resizable: se a janela puder ser redimensionada pelo usuário. O padrão é yes.

scrollbars: se a janela tiver barras de rolagem horizontais e verticais. O padrão é yes.

status: se a janela tiver uma barra de status na parte inferior. O padrão é yes.

titlebar: se o título da página atual for exibido. Definir essa opção como no não tem efeito em um aplicativo gerenciado; a barra de título sempre aparecerá.

toolbar: se os botões da barra de ferramentas como Voltar, Avançar, e Parar estiverem visíveis. O padrão é yes.

top: a posição (coordenada y) superior da janela em relação ao canto superior esquerdo da tela do usuário, em pixels. Deve ser um número inteiro positivo.

width: a largura da área de cliente da janela, em pixels. O mínimo é de 100; tentativas de abrir uma janela menor do que isso fará a janela ser aberta conforme os padrões do Internet Explorer.

replaceEntry
Boolean

true para substituir a URL da janela atual pelo url no histórico de navegação. Isso afetará a operação de métodos na HtmlHistory classe .

Retornos

HtmlWindow

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

Aplica-se a