Sdílet prostřednictvím

HtmlWindow.Open Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Zobrazí soubor v pojmenovaném okně.

Přetížení

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)

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);
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 v novém okně. Funguje stejně jako volání příkazu 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: Pokud je volána okno patřící k FRAME prvku, otevře se urlString v okně hostujícím jeho FRAMESET. V opačném případě se chová stejně jako _self.

windowOptions
String

Řetězec oddělený čárkami, který se skládá z nuly nebo více následujících možností ve tvaru name=value. S výjimkou leftmožností , top, heighta width , které přijímají libovolná celá čísla, každá možnost přijímá yes nebo 1, a no nebo 0, jako platné hodnoty.

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

directories: Určuje, jestli se v okně mají zobrazovat navigační tlačítka adresáře. Výchozí je yes.

height: Výška klientské oblasti okna v pixelech. Minimum je 100; Při pokusu o otevření menšího okna se okno otevře podle výchozích nastavení Aplikace Internet Explorer.

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

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

menubar: Určuje, jestli se mají v novém okně zobrazovat nabídky. Výchozí je yes.

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

scrollbars: Určuje, jestli má okno vodorovné a svislé posuvníky. Výchozí je yes.

status: Určuje, jestli je v okně dole stavový řádek. Výchozí je yes.

titlebar: Určuje, jestli se zobrazuje název aktuální stránky. Nastavení této možnosti na no nemá ve spravované aplikaci žádný vliv. Vždy se zobrazí záhlaví.

toolbar: Určuje, jestli jsou viditelná tlačítka panelu nástrojů, jako jsou Zpět, Vpřed a Zastavit . Výchozí je yes.

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

width: Šířka klientské oblasti okna v pixelech. Minimum je 100; Při pokusu o otevření menšího okna se okno otevře podle výchozích nastavení Aplikace Internet Explorer.

replaceEntry
Boolean

true a nahraďte adresu URL urlString aktuálního okna v historii navigace. To bude mít vliv na operaci metod na HtmlHistory třídu.

Návraty

HtmlWindow

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

Poznámky

Parametr target může pojmenovat Openokno, které bylo vytvořeno jako výsledek předchozího volání . Parametr může také odkazovat na okno otevřené kliknutím na hypertextový odkaz (A element) nebo FORM na element, který pomocí atributu TARGET otevře svou adresu URL v novém okně. Následující kód HTML otevře nové okno s názvem orderWindow , když na něj uživatel klikne:

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

Pokud pro parametr zadáte nějaké možnosti windowOptions , všechny nezahrnuté možnosti se automaticky deaktivuje. Jinými slovy, pokud chcete stavový řádek zadat pouze takwindowOptions, že chcete zobrazit řádek nabídek, panel nástrojů, nadpis, posuvníky atd., pokud je explicitně nepovolíte pomocí .windowOptions

Pokud je soubor, na který url odkazuje, soubor HTML, textový soubor nebo jiný typ souboru, který lze hostovat v aplikaci Internet Explorer, zobrazí se v pojmenovaném okně. Pokud soubor nelze zobrazit v aplikaci Internet Explorer a okno s názvem podle cíle již neexistuje, otevře se okno pouze dostatečně dlouho, aby aplikace Internet Explorer stáhnout prostředek; okamžitě poté se zavře.

Když vytvoříte nová okna pomocí nebo OpenOpenNew, způsobí to, že objektový model dokumentu HTML otevře novou instanci aplikace Internet Explorer. Pokud nezavoláte Close všechna okna, která jste vytvořili, zůstane tato instance Internet Exploreru 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ána. Okno si zachová rozměry, vzhled a umístění obrazovky, které mu bylo nejprve dáno počátečním voláním Open.

Platí pro

Open(Uri, String, String, Boolean)

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);
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 to být název zadaný vývojářem nebo jedna z následujících speciálních hodnot:

_blank: Otevře se url v novém okně. Funguje stejně jako volání příkazu 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: Pokud je volána okno patřící k FRAME prvku, otevře se url v okně hostujícím jeho FRAMESET. V opačném případě se chová stejně jako _self.

windowOptions
String

Řetězec oddělený čárkami, který se skládá z nuly nebo více následujících možností ve tvaru name=value. S výjimkou leftmožností , top, heighta width , které přijímají libovolná celá čísla, každá možnost přijímá yes nebo 1, a no nebo 0, jako platné hodnoty.

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

directories: Určuje, jestli se v okně mají zobrazovat navigační tlačítka adresáře. Výchozí je yes.

height: Výška klientské oblasti okna v pixelech. Minimum je 100; Při pokusu o otevření menšího okna se okno otevře podle výchozích nastavení Aplikace Internet Explorer.

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

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

menubar: Určuje, jestli se mají v novém okně zobrazovat nabídky. Výchozí je yes.

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

scrollbars: Určuje, jestli má okno vodorovné a svislé posuvníky. Výchozí je yes.

status: Určuje, jestli je v okně dole stavový řádek. Výchozí je yes.

titlebar: Určuje, jestli se zobrazuje název aktuální stránky. Nastavení této možnosti na no nemá ve spravované aplikaci žádný vliv. Vždy se zobrazí záhlaví.

toolbar: Určuje, jestli jsou viditelná tlačítka panelu nástrojů, jako jsou Zpět, Vpřed a Zastavit . Výchozí je yes.

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

width: Šířka klientské oblasti okna v pixelech. Minimum je 100; Při pokusu o otevření menšího okna se okno otevře podle výchozích nastavení Aplikace Internet Explorer.

replaceEntry
Boolean

true a nahraďte adresu URL url aktuálního okna v historii navigace. To bude mít vliv na 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 ovládacích prvků, které se zobrazí, závisí na tom, která adresa URL se otevře jako první. Příklad kódu vyžaduje, aby formulář obsahoval ovládací prvek WebBrowser 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 Openokno, které bylo vytvořeno jako výsledek předchozího volání . Parametr může také odkazovat na okno otevřené kliknutím na hypertextový odkaz (A element) nebo FORM na element, který pomocí atributu TARGET otevře svou adresu URL v novém okně. Následující kód HTML otevře nové okno s názvem orderWindow , když na něj uživatel klikne:

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

Pokud pro parametr zadáte nějaké možnosti windowOptions , všechny nezahrnuté možnosti se automaticky deaktivuje. Jinými slovy, pokud chcete stavový řádek zadat pouze takwindowOptions, že chcete zobrazit řádek nabídek, panel nástrojů, nadpis, posuvníky atd., pokud je explicitně nepovolíte pomocí .windowOptions

Pokud je soubor, na který url odkazuje, soubor HTML, textový soubor nebo jiný typ souboru, který lze hostovat v aplikaci Internet Explorer, zobrazí se v pojmenovaném okně. Pokud soubor nelze zobrazit v aplikaci Internet Explorer a okno s názvem podle cíle již neexistuje, otevře se okno pouze dostatečně dlouho, aby aplikace Internet Explorer stáhnout prostředek; okamžitě poté se zavře.

Když vytvoříte nová okna pomocí nebo OpenOpenNew, způsobí to, že objektový model dokumentu HTML otevře novou instanci aplikace Internet Explorer. Pokud nezavoláte Close všechna okna, která jste vytvořili, zůstane tato instance Internet Exploreru 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ána. Okno si zachová rozměry, vzhled a umístění obrazovky, které mu bylo nejprve dáno počátečním voláním Open.

Viz také

Platí pro