Bahasa

HtmlWindow.Open Metode

Definisi

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

Menampilkan file di jendela bernama.

Overload

Nama Deskripsi
Open(String, String, String, Boolean)

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

Menampilkan file di jendela bernama.

Open(String, String, String, Boolean)

Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs

Menampilkan file di 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: Membuka 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 FRAME di jendela yang menghostingnya .urlStringFRAMESET Jika tidak, bertindak sama dengan _self.

windowOptions
String

String yang dibatasi koma yang terdiri dari nol atau beberapa opsi berikut dalam formulir name=value. Kecuali untuk leftopsi , , topheight, 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 yang tidak digunakan lagi Internet Explorer 4.0. 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 dalam 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 secara otomatis dinonaktifkan. Dengan kata lain, jika Anda hanya menentukan dengan cara windowOptions yang Anda inginkan untuk 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 berdasarkan target belum ada, maka jendela hanya akan terbuka cukup lama agar Internet Explorer mengunduh sumber daya; jendela 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 di 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 terlebih dahulu diberikan oleh panggilan awal ke Open.

Berlaku untuk

Open(Uri, String, String, Boolean)

Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs
Sumber:
HtmlWindow.cs

Menampilkan file di 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: Membuka 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 FRAME di jendela yang menghostingnya .urlFRAMESET Jika tidak, bertindak sama dengan _self.

windowOptions
String

String yang dibatasi koma yang terdiri dari nol atau beberapa opsi berikut dalam formulir name=value. Kecuali untuk leftopsi , , topheight, 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 yang tidak digunakan lagi Internet Explorer 4.0. 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 dalam riwayat navigasi. Ini akan memengaruhi pengoperasian metode pada HtmlHistory kelas.

Mengembalikan

HtmlWindow

Mewakili HtmlWindow jendela baru, atau jendela yang dibuat sebelumnya yang 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 secara otomatis dinonaktifkan. Dengan kata lain, jika Anda hanya menentukan dengan cara windowOptions yang Anda inginkan untuk 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 berdasarkan target belum ada, maka jendela hanya akan terbuka cukup lama agar Internet Explorer mengunduh sumber daya; jendela 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 di 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 terlebih dahulu diberikan oleh panggilan awal ke Open.

Lihat juga

Berlaku untuk