Bagikan melalui

HtmlWindow.Open Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Menampilkan file dalam jendela bernama.

Overload

Open(String, String, String, Boolean)

Menampilkan file dalam jendela bernama.
Open(Uri, String, String, Boolean)

Menampilkan file dalam jendela bernama.

Open(String, String, String, Boolean)

Menampilkan file dalam jendela bernama.

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

Parameter

urlString
String

Pencari Sumber Daya Seragam yang menjelaskan lokasi file yang akan dimuat.

target
String

Nama jendela untuk membuka sumber daya. Ini mungkin nama yang disediakan pengembang, atau salah satu nilai khusus berikut:

_blank: Terbuka urlString di jendela baru. Bekerja sama dengan panggilan ke OpenNew(String, String).

_media: Terbuka urlString di bilah Media.

_parent: Membuka urlString di jendela yang membuat jendela saat ini.

_search: Terbuka urlString di bilah Pencarian.

_self: Terbuka urlString di jendela saat ini.

_top: Jika dipanggil terhadap jendela milik elemen , terbuka urlString di jendela yang menghosting FRAME .FRAMESET Jika tidak, bertindak sama seperti _self.

windowOptions
String

String yang dibatasi koma yang terdiri dari nol atau beberapa opsi berikut dalam formulir name=value. Kecuali untuk leftopsi , top, height, dan width , yang mengambil bilangan bulat arbitrer, setiap opsi menerima yes atau 1, dan no atau 0, sebagai nilai yang valid.

channelmode: Digunakan dengan teknologi saluran Internet Explorer 4.0 yang tidak digunakan lagi. Defaultnya adalah no.

directories: Apakah jendela harus menampilkan tombol navigasi direktori. Defaultnya adalah yes.

height: Tinggi area klien jendela, dalam piksel. Minimumnya adalah 100; mencoba membuka jendela yang lebih kecil dari ini akan menyebabkan jendela terbuka sesuai dengan default Internet Explorer.

left: Posisi kiri (koordinat x) jendela, relatif terhadap sudut kiri atas layar pengguna, dalam piksel. Harus berupa nilai bilangan bulat positif.

location: Apakah akan menampilkan bilah Alamat, yang memungkinkan pengguna menavigasi jendela ke URL baru. Defaultnya adalah yes.

menubar: Apakah akan menampilkan menu pada jendela baru. Defaultnya adalah yes.

resizable: Apakah jendela dapat diubah ukurannya oleh pengguna. Defaultnya adalah yes.

scrollbars: Apakah jendela memiliki bilah gulir horizontal dan vertikal. Defaultnya adalah yes.

status: Apakah jendela memiliki bilah status di bagian bawah. Defaultnya adalah yes.

titlebar: Apakah judul halaman saat ini ditampilkan. Mengatur opsi ini agar no tidak berpengaruh dalam aplikasi terkelola; bilah judul akan selalu muncul.

toolbar: Apakah tombol toolbar seperti Back, Forward, dan Stop terlihat. Defaultnya adalah yes.

top: Posisi atas (koordinat y) jendela, relatif terhadap sudut kiri atas layar pengguna, dalam piksel. Harus berupa nilai bilangan bulat positif.

width: Lebar area klien jendela, dalam piksel. Minimumnya adalah 100; mencoba membuka jendela yang lebih kecil dari ini akan menyebabkan jendela terbuka sesuai dengan default Internet Explorer.

replaceEntry
Boolean

true untuk mengganti URL jendela saat ini dengan urlString di riwayat navigasi. Ini akan mempengaruhi pengoperasian metode pada HtmlHistory kelas .

Mengembalikan

HtmlWindow

Jendela baru, atau jendela yang dibuat sebelumnya dinamai target oleh parameter .

Keterangan

Parameter target dapat memberi nama jendela yang dibuat sebagai hasil dari panggilan sebelumnya ke Open. Parameter juga dapat menunjuk ke jendela yang dibuka dengan mengklik hyperlink (A elemen) atau FORM elemen yang menggunakan TARGET atribut untuk membuka URL-nya di jendela baru. Kode HTML berikut akan membuka jendela baru bernama orderWindow saat pengguna mengkliknya:

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

Jika Anda menyediakan opsi apa pun untuk windowOptions parameter , opsi apa pun yang tidak disertakan akan dinonaktifkan secara otomatis. Dengan kata lain, jika Anda hanya menentukan dengan cara windowOptions yang Anda inginkan bilah status, maka bilah menu, toolbar, judul, bilah gulir, dan sebagainya tidak akan ditampilkan kecuali Anda secara eksplisit mengaktifkannya dengan cara windowOptions.

Jika file yang direferensikan oleh url adalah file HTML, file teks, atau jenis file lain yang dapat dihosting di dalam Internet Explorer, file tersebut akan ditampilkan di jendela bernama. Jika file tidak dapat ditampilkan di dalam Internet Explorer, dan jendela yang dinamai oleh target belum ada, maka jendela hanya akan terbuka cukup lama bagi Internet Explorer untuk mengunduh sumber daya; akan segera ditutup setelahnya.

Saat Anda membuat jendela baru menggunakan Open atau OpenNew, hal ini menyebabkan Model Objek Dokumen HTML membuka instans baru Internet Explorer. Jika Anda tidak memanggil Close semua jendela yang telah Anda buat, instans Internet Explorer ini akan tetap berjalan bahkan setelah aplikasi Anda berhenti.

Jika Anda menggunakan Open untuk memuat URL di jendela yang ada, windowOptions akan diabaikan; jendela akan mempertahankan dimensi, tampilan, dan lokasi layar yang pertama kali diberikan oleh panggilan awal ke Open.

Berlaku untuk

Open(Uri, String, String, Boolean)

Menampilkan file dalam jendela bernama.

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

Parameter

url
Uri

Pencari Sumber Daya Seragam yang menjelaskan lokasi file yang akan dimuat.

target
String

Nama jendela untuk membuka sumber daya. Ini bisa menjadi nama yang disediakan pengembang, atau salah satu nilai khusus berikut:

_blank: Terbuka url di jendela baru. Bekerja sama dengan panggilan ke OpenNew(String, String).

_media: Terbuka url di bilah Media.

_parent: Membuka url di jendela yang membuat jendela saat ini.

_search: Terbuka url di bilah Pencarian.

_self: Terbuka url di jendela saat ini.

_top: Jika dipanggil terhadap jendela milik elemen , terbuka url di jendela yang menghosting FRAME .FRAMESET Jika tidak, bertindak sama seperti _self.

windowOptions
String

String yang dibatasi koma yang terdiri dari nol atau beberapa opsi berikut dalam formulir name=value. Kecuali untuk leftopsi , top, height, dan width , yang mengambil bilangan bulat arbitrer, setiap opsi menerima yes atau 1, dan no atau 0, sebagai nilai yang valid.

channelmode: Digunakan dengan teknologi saluran Internet Explorer 4.0 yang tidak digunakan lagi. Defaultnya adalah no.

directories: Apakah jendela harus menampilkan tombol navigasi direktori. Defaultnya adalah yes.

height: Tinggi area klien jendela, dalam piksel. Minimumnya adalah 100; mencoba membuka jendela yang lebih kecil dari ini akan menyebabkan jendela terbuka sesuai dengan default Internet Explorer.

left: Posisi kiri (koordinat x) jendela, relatif terhadap sudut kiri atas layar pengguna, dalam piksel. Harus berupa nilai bilangan bulat positif.

location: Apakah akan menampilkan bilah Alamat, yang memungkinkan pengguna menavigasi jendela ke URL baru. Defaultnya adalah yes.

menubar: Apakah akan menampilkan menu pada jendela baru. Defaultnya adalah yes.

resizable: Apakah jendela dapat diubah ukurannya oleh pengguna. Defaultnya adalah yes.

scrollbars: Apakah jendela memiliki bilah gulir horizontal dan vertikal. Defaultnya adalah yes.

status: Apakah jendela memiliki bilah status di bagian bawah. Defaultnya adalah yes.

titlebar: Apakah judul halaman saat ini ditampilkan. Mengatur opsi ini agar no tidak berpengaruh dalam aplikasi terkelola; bilah judul akan selalu muncul.

toolbar: Apakah tombol toolbar seperti Back, Forward, dan Stop terlihat. Defaultnya adalah yes.

top: Posisi atas (koordinat y) jendela, relatif terhadap sudut kiri atas layar pengguna, dalam piksel. Harus berupa nilai bilangan bulat positif.

width: Lebar area klien jendela, dalam piksel. Minimumnya adalah 100; mencoba membuka jendela yang lebih kecil dari ini akan menyebabkan jendela terbuka sesuai dengan default Internet Explorer.

replaceEntry
Boolean

true untuk mengganti URL jendela saat ini dengan url di riwayat navigasi. Ini akan memengaruhi pengoperasian metode pada HtmlHistory kelas .

Mengembalikan

HtmlWindow

Yang HtmlWindow mewakili jendela baru, atau jendela yang dibuat sebelumnya dinamai target oleh parameter .

Contoh

Contoh kode berikut berisi dua metode:

  • Yang pertama membuka URL di jendela bernama displayWindow, yang dibuatnya dengan bilah status ditampilkan.
  • Yang kedua membuka URL lain di jendela yang sama, tetapi menentukan bahwa hanya bilah lokasi yang harus ditampilkan.

Perhatikan bahwa dimensi jendela dan kontrol yang ditampilkan bergantung pada URL mana yang dibuka terlebih dahulu. Contoh kode mengharuskan formulir Anda berisi WebBrowser kontrol bernama 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

Keterangan

Parameter target dapat memberi nama jendela yang dibuat sebagai hasil dari panggilan sebelumnya ke Open. Parameter juga dapat menunjuk ke jendela yang dibuka dengan mengklik hyperlink (A elemen) atau FORM elemen yang menggunakan TARGET atribut untuk membuka URL-nya di jendela baru. Kode HTML berikut akan membuka jendela baru bernama orderWindow saat pengguna mengkliknya:

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

Jika Anda menyediakan opsi apa pun untuk windowOptions parameter , opsi apa pun yang tidak disertakan akan dinonaktifkan secara otomatis. Dengan kata lain, jika Anda hanya menentukan dengan cara windowOptions yang Anda inginkan bilah status, maka bilah menu, toolbar, judul, bilah gulir, dan sebagainya tidak akan ditampilkan kecuali Anda secara eksplisit mengaktifkannya dengan cara windowOptions.

Jika file yang direferensikan oleh url adalah file HTML, file teks, atau jenis file lain yang dapat dihosting di dalam Internet Explorer, file tersebut akan ditampilkan di jendela bernama. Jika file tidak dapat ditampilkan di dalam Internet Explorer, dan jendela yang dinamai oleh target belum ada, maka jendela hanya akan terbuka cukup lama bagi Internet Explorer untuk mengunduh sumber daya; akan segera ditutup setelahnya.

Saat Anda membuat jendela baru menggunakan Open atau OpenNew, hal ini menyebabkan Model Objek Dokumen HTML membuka instans baru Internet Explorer. Jika Anda tidak memanggil Close semua jendela yang telah Anda buat, instans Internet Explorer ini akan tetap berjalan bahkan setelah aplikasi Anda berhenti.

Jika Anda menggunakan Open untuk memuat URL di jendela yang ada, windowOptions akan diabaikan; jendela akan mempertahankan dimensi, tampilan, dan lokasi layar yang pertama kali diberikan oleh panggilan awal ke Open.

Lihat juga

Berlaku untuk