HtmlWindow.Open Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Egy fájl megjelenítése a névvel ellátott ablakban.

Túlterhelések

Név	Description
Open(String, String, String, Boolean)	Egy fájl megjelenítése a névvel ellátott ablakban.
Open(Uri, String, String, Boolean)	Egy fájl megjelenítése a névvel ellátott ablakban.

Open(String, String, String, Boolean)

Forrás:

HtmlWindow.cs

Egy fájl megjelenítése a névvel ellátott ablakban.

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

Paraméterek

urlString

String

A betöltendő fájl helyét leíró egységes erőforrás-kereső.

target

String

Annak az ablaknak a neve, amelyben meg szeretné nyitni az erőforrást. Ez lehet egy fejlesztő által megadott név, vagy az alábbi speciális értékek egyike:

_blank: Új ablakban nyílik meg urlString . Ugyanúgy működik, mint a hívás.OpenNew(String, String)

_media: Megnyílik urlString a Médiasávon.

_parent: Az aktuális ablakot létrehozó ablakban nyílik meg urlString .

_search: Megnyílik urlString a Keresősávon.

_self: Az aktuális ablakban nyílik meg urlString .

_top: Ha egy elemhez FRAME tartozó ablakra van meghívva, az annak ablakában urlStringnyílik megFRAMESET. Ellenkező esetben ugyanúgy működik, mint a _self.

windowOptions

String

Vesszővel tagolt sztring, amely az alábbi lehetőségek közül nullából vagy többből áll az űrlapon name=value. leftA tetszőleges egész számokat vevő , top, , heightés width beállítások kivételével minden beállítás érvényes értékként fogadja el yes vagy1, no vagy 0pedig érvényes értékként.

channelmode: A Internet Explorer 4.0 elavult csatornáinak technológiájával használható. Az alapértelmezett érték no.

directories: Azt jelzi, hogy az ablakban megjelenjenek-e a könyvtár navigációs gombjai. Az alapértelmezett érték yes.

height: Az ablak ügyfélterületének magassága képpontban. A minimum 100; Az ennél kisebb ablak megnyitása esetén az ablak az alapértelmezett Internet Explorer szerint nyílik meg.

left: Az ablak bal (x koordinátás) helyzete a felhasználó képernyőjének bal felső sarkához viszonyítva képpontban. Pozitív egész számnak kell lennie.

location: Megjelenítheti-e a címsort, amely lehetővé teszi, hogy a felhasználók új URL-címre navigáljanak az ablakban. Az alapértelmezett érték yes.

menubar: A menük megjelenítése az új ablakban. Az alapértelmezett érték yes.

resizable: Azt jelzi, hogy a felhasználó átméretezheti-e az ablakot. Az alapértelmezett érték yes.

scrollbars: Az ablak vízszintes és függőleges görgetősávokkal rendelkezik-e. Az alapértelmezett érték yes.

status: Azt jelzi, hogy az ablak alján van-e állapotsor. Az alapértelmezett érték yes.

titlebar: Megjelenik-e az aktuális lap címe. Ha ezt a beállítást úgy állítja be, hogy no nincs hatása egy felügyelt alkalmazáson belül, a címsor mindig megjelenik.

toolbar: Láthatóak-e az eszköztárgombok, például a Vissza, az Előre és a Leállítás gomb. Az alapértelmezett érték yes.

top: Az ablak felső (y koordinátás) pozíciója a felhasználó képernyőjének bal felső sarkához viszonyítva képpontban. Pozitív egész számnak kell lennie.

width: Az ablak ügyfélterületének szélessége képpontban. A minimum 100; Az ennél kisebb ablak megnyitása esetén az ablak az alapértelmezett Internet Explorer szerint nyílik meg.

replaceEntry

Boolean

true az aktuális ablak URL-címének urlString lecseréléséhez a navigációs előzményekben. Ez hatással lesz a metódusok működésére az HtmlHistory osztályon.

Válaszok

HtmlWindow

Az új ablak vagy a paraméter által target korábban létrehozott ablak.

Megjegyzések

A target paraméter nevet adhat egy ablaknak, amelyet egy korábbi hívás eredményeként hoztak Openlétre. A paraméter egy megnyitott ablakra is mutathat, ha egy hivatkozásra (A elemre) kattint, vagy egy FORM olyan elemre, amely az attribútumot használja az TARGET URL-cím új ablakban való megnyitásához. A következő HTML-kód egy új, a felhasználó kattintásakor elnevezett orderWindow ablakot nyit meg:

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

Ha a paraméterhez bármilyen beállítást megad, a windowOptions nem tartalmazott beállítások automatikusan le lesznek tiltva. Más szóval, ha csak úgy windowOptions adja meg, hogy egy állapotsort szeretne, akkor a menüsáv, az eszköztár, a cím, a görgetősávok és így tovább csak akkor jelennek meg, ha kifejezetten engedélyezi őket windowOptions.

Ha a url által hivatkozott fájl egy HTML-fájl, szövegfájl vagy más fájltípus, amely a Internet Explorer belül üzemeltethető, akkor a névvel ellátott ablakban jelenik meg. Ha a fájl nem jeleníthető meg a Internet Explorer belül, és a cél által elnevezett ablak még nem létezik, akkor az ablak csak annyi ideig nyílik meg, hogy Internet Explorer töltse le az erőforrást; ezt követően azonnal bezáródik.

Amikor új ablakokat hoz létre Open vagy OpenNew használatával, a HTML-dokumentumobjektum-modell megnyit egy új Internet Explorer-példányt. Ha nem hívja meg a Close az összes létrehozott ablakban, akkor a Internet Explorer ezen példánya az alkalmazás kilépése után is futni fog.

Ha egy url-címet egy meglévő ablakban tölt Open be, windowOptions a rendszer figyelmen kívül hagyja; az ablak megőrzi a dimenziókat, a megjelenést és a képernyő helyét, először a kezdeti hívás Opensorán.

Open(Uri, String, String, Boolean)

Forrás:

HtmlWindow.cs

Egy fájl megjelenítése a névvel ellátott ablakban.

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

Paraméterek

url

Uri

A betöltendő fájl helyét leíró egységes erőforrás-kereső.

target

String

Annak az ablaknak a neve, amelyben meg szeretné nyitni az erőforrást. Ez lehet egy fejlesztő által megadott név, vagy az alábbi speciális értékek egyike:

_blank: Új ablakban nyílik meg url . Ugyanúgy működik, mint a hívás.OpenNew(String, String)

_media: Megnyílik url a Médiasávon.

_parent: Az aktuális ablakot létrehozó ablakban nyílik meg url .

_search: Megnyílik url a Keresősávon.

_self: Az aktuális ablakban nyílik meg url .

_top: Ha egy elemhez FRAME tartozó ablakra van meghívva, az annak ablakában urlnyílik megFRAMESET. Ellenkező esetben ugyanúgy működik, mint a _self.

windowOptions

String

Vesszővel tagolt sztring, amely az alábbi lehetőségek közül nullából vagy többből áll az űrlapon name=value. leftA tetszőleges egész számokat vevő , top, , heightés width beállítások kivételével minden beállítás érvényes értékként fogadja el yes vagy1, no vagy 0pedig érvényes értékként.

channelmode: A Internet Explorer 4.0 elavult csatornáinak technológiájával használható. Az alapértelmezett érték no.

directories: Azt jelzi, hogy az ablakban megjelenjenek-e a könyvtár navigációs gombjai. Az alapértelmezett érték yes.

height: Az ablak ügyfélterületének magassága képpontban. A minimum 100; Az ennél kisebb ablak megnyitása esetén az ablak az alapértelmezett Internet Explorer szerint nyílik meg.

left: Az ablak bal (x koordinátás) helyzete a felhasználó képernyőjének bal felső sarkához viszonyítva képpontban. Pozitív egész számnak kell lennie.

location: Megjelenítheti-e a címsort, amely lehetővé teszi, hogy a felhasználók új URL-címre navigáljanak az ablakban. Az alapértelmezett érték yes.

menubar: A menük megjelenítése az új ablakban. Az alapértelmezett érték yes.

resizable: Azt jelzi, hogy a felhasználó átméretezheti-e az ablakot. Az alapértelmezett érték yes.

scrollbars: Az ablak vízszintes és függőleges görgetősávokkal rendelkezik-e. Az alapértelmezett érték yes.

status: Azt jelzi, hogy az ablak alján van-e állapotsor. Az alapértelmezett érték yes.

titlebar: Megjelenik-e az aktuális lap címe. Ha ezt a beállítást úgy állítja be, hogy no nincs hatása egy felügyelt alkalmazáson belül, a címsor mindig megjelenik.

toolbar: Láthatóak-e az eszköztárgombok, például a Vissza, az Előre és a Leállítás gomb. Az alapértelmezett érték yes.

top: Az ablak felső (y koordinátás) pozíciója a felhasználó képernyőjének bal felső sarkához viszonyítva képpontban. Pozitív egész számnak kell lennie.

width: Az ablak ügyfélterületének szélessége képpontban. A minimum 100; Az ennél kisebb ablak megnyitása esetén az ablak az alapértelmezett Internet Explorer szerint nyílik meg.

replaceEntry

Boolean

true az aktuális ablak URL-címének url lecseréléséhez a navigációs előzményekben. Ez hatással lesz az osztály metódusainak működésére HtmlHistory .

Válaszok

HtmlWindow

Az HtmlWindow új ablakot vagy a paraméter által target korábban létrehozott ablakot jelképező ablak.

Példák

Az alábbi példakód két metódust tartalmaz:

• Az első egy URL-címet nyit meg egy névvel ellátott displayWindowablakban, amelyet egy állapotsorsal hoz létre.
• A második egy másik URL-címet nyit meg ugyanabban az ablakban, de megadja, hogy csak a helysáv jelenjen meg.

Figyelje meg, hogy az ablak méretei és a megjelenő vezérlők attól függenek, hogy melyik URL-címet nyitja meg először. A példakód megköveteli, hogy az űrlap tartalmazjon egy nevű vezérlőt WebBrowserWebBrowser1.

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

Megjegyzések

A target paraméter nevet adhat egy ablaknak, amelyet egy korábbi hívás eredményeként hoztak Openlétre. A paraméter egy megnyitott ablakra is mutathat, ha egy hivatkozásra (A elemre) kattint, vagy egy FORM olyan elemre, amely az attribútumot használja az TARGET URL-cím új ablakban való megnyitásához. A következő HTML-kód egy új, a felhasználó kattintásakor elnevezett orderWindow ablakot nyit meg:

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

Ha a paraméterhez bármilyen beállítást megad, a windowOptions nem tartalmazott beállítások automatikusan le lesznek tiltva. Más szóval, ha csak úgy windowOptions adja meg, hogy egy állapotsort szeretne, akkor a menüsáv, az eszköztár, a cím, a görgetősávok és így tovább csak akkor jelennek meg, ha kifejezetten engedélyezi őket windowOptions.

Ha a url által hivatkozott fájl egy HTML-fájl, szövegfájl vagy más fájltípus, amely a Internet Explorer belül üzemeltethető, akkor a névvel ellátott ablakban jelenik meg. Ha a fájl nem jeleníthető meg a Internet Explorer belül, és a cél által elnevezett ablak még nem létezik, akkor az ablak csak annyi ideig nyílik meg, hogy Internet Explorer töltse le az erőforrást; ezt követően azonnal bezáródik.

Amikor új ablakokat hoz létre Open vagy OpenNew használatával, a HTML-dokumentumobjektum-modell megnyit egy új Internet Explorer-példányt. Ha nem hívja meg a Close az összes létrehozott ablakban, akkor a Internet Explorer ezen példánya az alkalmazás kilépése után is futni fog.

Ha egy url-címet egy meglévő ablakban tölt Open be, windowOptions a rendszer figyelmen kívül hagyja; az ablak megőrzi a dimenziókat, a megjelenést és a képernyő helyét, először a kezdeti hívás Opensorán.

Lásd még

• open Method