HtmlWindow.Open Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zobrazí soubor v pojmenovaném okně.

Přetížení

Name	Description
Open(String, String, String, Boolean)	Zobrazí soubor v pojmenovaném okně.
Open(Uri, String, String, Boolean)	Zobrazí soubor v pojmenovaném okně.

Open(String, String, String, Boolean)

Zdroj:

HtmlWindow.cs

Zobrazí soubor v pojmenovaném okně.

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

Parametry

urlString

String

Lokátor Uniform Resource Locator, který popisuje umístění souboru, který se má načíst.

target

String

Název okna, ve kterém se má prostředek otevřít. Může se jednat o název zadaný vývojářem nebo jednu z následujících speciálních hodnot:

_blank: Otevře se urlString nové okno. Funguje stejně jako volání OpenNew(String, String).

_media: Otevře se urlString na panelu Multimédia.

_parent: Otevře se urlString v okně, které vytvořilo aktuální okno.

_search: Otevře se urlString na panelu hledání.

_self: Otevře se urlString v aktuálním okně.

_top: Je-li volána proti oknu patřícímu FRAME prvku, otevře se urlString v okně, které je hostitelem jeho FRAMESET. V opačném případě se chová stejně jako _self.

windowOptions

String

Řetězec oddělený čárkami skládající se z nuly nebo více následujících možností ve formuláři name=value. leftKromě možností , , topheighta width možnosti, které přijímají libovolná celá čísla, každá možnost přijímá yes nebo 1nebo , no0jako platné hodnoty.

channelmode: Používá se s zastaralou technologií kanálů Internet Explorer 4.0. Výchozí hodnota je no.

directories: Zda má okno zobrazovat navigační tlačítka adresáře. Výchozí hodnota je yes.

height: Výška klientské oblasti okna v pixelech. Minimum je 100; pokusy o otevření menšího okna způsobí otevření okna podle výchozího nastavení Internet Explorer.

left: Pozice okna vlevo (souřadnice x) vzhledem k levému hornímu rohu obrazovky uživatele v pixelech. Musí to být kladné celé číslo.

location: Určuje, jestli se má zobrazit panel Adresa, který uživatelům umožňuje přejít do okna na novou adresu URL. Výchozí hodnota je yes.

menubar: Zda se mají zobrazovat nabídky v novém okně. Výchozí hodnota je yes.

resizable: Určuje, zda může uživatel změnit velikost okna. Výchozí hodnota je yes.

scrollbars: Určuje, zda okno obsahuje vodorovné a svislé posuvníky. Výchozí hodnota je yes.

status: Zda okno obsahuje stavový řádek v dolní části. Výchozí hodnota je yes.

titlebar: Určuje, zda se zobrazí název aktuální stránky. Nastavení této možnosti tak, aby no ve spravované aplikaci nemělo žádný vliv. Záhlaví se vždy zobrazí.

toolbar: Určuje, zda jsou zobrazena tlačítka panelu nástrojů, například Zpět, Vpřed a Zarážka . Výchozí hodnota je yes.

top: Horní pozice okna (souřadnice y) vzhledem k levému hornímu rohu obrazovky uživatele v pixelech. Musí to být kladné celé číslo.

width: Šířka klientské oblasti okna v pixelech. Minimum je 100; pokusy o otevření menšího okna způsobí otevření okna podle výchozího nastavení Internet Explorer.

replaceEntry

Boolean

true pokud chcete nahradit adresu URL urlString aktuálního okna v historii navigace. Tím se projeví operace metod ve HtmlHistory třídě.

Návraty

HtmlWindow

Nové okno nebo dříve vytvořené okno pojmenované parametrem target .

Poznámky

Parametr target může pojmenovat okno vytvořené v důsledku předchozího volání Open. Parametr může také odkazovat na okno otevřené kliknutím na hypertextový odkaz (A element) nebo FORM element, který používá TARGET atribut k otevření jeho adresy URL v novém okně. Následující kód HTML otevře nové okno pojmenované orderWindow , když na něj uživatel klikne:

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

Pokud zadáte jakékoli možnosti parametru windowOptions , nezahrnou se automaticky všechny možnosti, které nejsou zahrnuty. Jinými slovy, pokud zadáte pouze takwindowOptions, že chcete stavový řádek, pak řádek nabídek, panel nástrojů, název, posuvníky a tak dále se nezobrazí, pokud je explicitně nepovolíte.windowOptions

Pokud je soubor odkazovaný url html soubor, textový soubor nebo jiný typ souboru, který lze hostovat uvnitř Internet Explorer, zobrazí se v pojmenovaném okně. Pokud soubor nelze zobrazit uvnitř Internet Explorer a okno pojmenované cílem ještě neexistuje, otevře se okno dostatečně dlouho, aby se Internet Explorer stáhnout prostředek. Zavře se hned potom.

Při vytváření nových oken pomocí Open nebo OpenNew způsobí, že objektový model dokumentu HTML otevře novou instanci Internet Explorer. Pokud nevoláte Close ve všech vytvořených oknech, zůstane tato instance Internet Explorer spuštěná i po ukončení aplikace.

Pokud použijete Open k načtení adresy URL v existujícím okně, windowOptions bude ignorováno; okno si zachová rozměry, vzhled a umístění obrazovky, které mu bylo poprvé dáno počátečním voláním Open.

Open(Uri, String, String, Boolean)

Zdroj:

HtmlWindow.cs

Zobrazí soubor v pojmenovaném okně.

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

Parametry

url

Uri

Lokátor Uniform Resource Locator, který popisuje umístění souboru, který se má načíst.

target

String

Název okna, ve kterém se má prostředek otevřít. Může se jednat o název zadaný vývojářem nebo jednu z následujících speciálních hodnot:

_blank: Otevře se url nové okno. Funguje stejně jako volání OpenNew(String, String).

_media: Otevře se url na panelu Multimédia.

_parent: Otevře se url v okně, které vytvořilo aktuální okno.

_search: Otevře se url na panelu hledání.

_self: Otevře se url v aktuálním okně.

_top: Je-li volána proti oknu patřícímu FRAME prvku, otevře se url v okně, které je hostitelem jeho FRAMESET. V opačném případě se chová stejně jako _self.

windowOptions

String

Řetězec oddělený čárkami skládající se z nuly nebo více následujících možností ve formuláři name=value. leftKromě možností , , topheighta width možnosti, které přijímají libovolná celá čísla, každá možnost přijímá yes nebo 1nebo , no0jako platné hodnoty.

channelmode: Používá se s zastaralou technologií kanálů Internet Explorer 4.0. Výchozí hodnota je no.

directories: Zda má okno zobrazovat navigační tlačítka adresáře. Výchozí hodnota je yes.

height: Výška klientské oblasti okna v pixelech. Minimum je 100; pokusy o otevření menšího okna způsobí otevření okna podle výchozího nastavení Internet Explorer.

left: Pozice okna vlevo (souřadnice x) vzhledem k levému hornímu rohu obrazovky uživatele v pixelech. Musí to být kladné celé číslo.

location: Určuje, jestli se má zobrazit panel Adresa, který uživatelům umožňuje přejít do okna na novou adresu URL. Výchozí hodnota je yes.

menubar: Zda se mají zobrazovat nabídky v novém okně. Výchozí hodnota je yes.

resizable: Určuje, zda může uživatel změnit velikost okna. Výchozí hodnota je yes.

scrollbars: Určuje, zda okno obsahuje vodorovné a svislé posuvníky. Výchozí hodnota je yes.

status: Zda okno obsahuje stavový řádek v dolní části. Výchozí hodnota je yes.

titlebar: Určuje, zda se zobrazí název aktuální stránky. Nastavení této možnosti tak, aby no ve spravované aplikaci nemělo žádný vliv. Záhlaví se vždy zobrazí.

toolbar: Určuje, zda jsou zobrazena tlačítka panelu nástrojů, například Zpět, Vpřed a Zarážka . Výchozí hodnota je yes.

top: Horní pozice okna (souřadnice y) vzhledem k levému hornímu rohu obrazovky uživatele v pixelech. Musí to být kladné celé číslo.

width: Šířka klientské oblasti okna v pixelech. Minimum je 100; pokusy o otevření menšího okna způsobí otevření okna podle výchozího nastavení Internet Explorer.

replaceEntry

Boolean

true pokud chcete nahradit adresu URL url aktuálního okna v historii navigace. To ovlivní provoz metod ve HtmlHistory třídě.

Návraty

HtmlWindow

Představuje HtmlWindow nové okno nebo dříve vytvořené okno pojmenované parametrem target .

Příklady

Následující příklad kódu obsahuje dvě metody:

• První otevře adresu URL v okně s názvem displayWindow, které vytvoří se zobrazeným stavovým řádkem.
• Druhá otevře další adresu URL ve stejném okně, ale určuje, že se má zobrazit jenom panel umístění.

Všimněte si, že rozměry okna a zobrazených ovládacích prvků závisí na tom, kterou adresu URL se otevře jako první. Příklad kódu vyžaduje, aby formulář obsahuje WebBrowser ovládací prvek s názvem 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

Poznámky

Parametr target může pojmenovat okno vytvořené v důsledku předchozího volání Open. Parametr může také odkazovat na okno otevřené kliknutím na hypertextový odkaz (A element) nebo FORM element, který používá TARGET atribut k otevření jeho adresy URL v novém okně. Následující kód HTML otevře nové okno pojmenované orderWindow , když na něj uživatel klikne:

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

Pokud zadáte jakékoli možnosti parametru windowOptions , nezahrnou se automaticky všechny možnosti, které nejsou zahrnuty. Jinými slovy, pokud zadáte pouze takwindowOptions, že chcete stavový řádek, pak řádek nabídek, panel nástrojů, název, posuvníky a tak dále se nezobrazí, pokud je explicitně nepovolíte.windowOptions

Pokud je soubor odkazovaný url html soubor, textový soubor nebo jiný typ souboru, který lze hostovat uvnitř Internet Explorer, zobrazí se v pojmenovaném okně. Pokud soubor nelze zobrazit uvnitř Internet Explorer a okno pojmenované cílem ještě neexistuje, otevře se okno dostatečně dlouho, aby se Internet Explorer stáhnout prostředek. Zavře se hned potom.

Při vytváření nových oken pomocí Open nebo OpenNew způsobí, že objektový model dokumentu HTML otevře novou instanci Internet Explorer. Pokud nevoláte Close ve všech vytvořených oknech, zůstane tato instance Internet Explorer spuštěná i po ukončení aplikace.

Pokud použijete Open k načtení adresy URL v existujícím okně, windowOptions bude ignorováno; okno si zachová rozměry, vzhled a umístění obrazovky, které mu bylo poprvé dáno počátečním voláním Open.

Viz také

• open – metoda