HtmlWindow Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili jendela logis yang berisi satu atau beberapa instans HtmlDocument.
public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
- Warisan
-
HtmlWindow
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
HtmlWindow tidak boleh dikacaukan dengan konsep jendela di Windows Forms atau Windows API; tidak HWND
ada atau sumber daya Windows serupa yang sesuai langsung dengan instans HtmlWindow. Sebaliknya, HtmlWindow memberikan deskripsi tingkat tinggi tentang lokasi dokumen di layar pengguna, serta metode untuk berinteraksi dengan pengguna melalui perintah dan kotak dialog.
HtmlWindow bertindak sebagai kontainer logis untuk dokumen halaman Web dan metadatanya, seperti lokasi dokumen dan kemampuan browser Web.
Halaman Web terdiri dari satu dokumen, atau yang FRAMESET
berisi satu atau beberapa FRAME
elemen, yang masing-masing menghosting dokumennya sendiri. Pengembang web menggunakan frameset untuk menampilkan halaman terkait secara logis berdampingan (misalnya, halaman konten di samping halaman navigasi). Saat halaman terdiri dari satu dokumen, Anda dapat mengaksesnya melalui Document properti HtmlWindow; jika halaman menggunakan bingkai, Anda dapat mengakses dokumennya melalui Frames koleksi, yang terdiri dari satu atau beberapa HtmlWindow objek.
Saat menghosting WebBrowser kontrol di aplikasi Windows Forms, Anda dapat memilih untuk berinteraksi dengan pengguna menggunakan kelas Windows Forms standar, seperti Form atau MessageBox, atau Anda dapat menggunakan metode yang HtmlWindow ditentukan untuk tujuan ini. Metode menyajikan Alert kotak dialog sederhana dengan teks kustom dan tombol OK ; Prompt menyajikan baris teks kustom dan bidang input teks kepada pengguna; dan Confirm menyajikan kotak dialog dengan baris teks kustom dan tombol OK dan Batal .
Anda dapat menggunakan HtmlWindow untuk membuka jendela baru yang berisi dokumen baru. Open memuat URL yang ditentukan ke dalam jendela bernama, membuatnya jika belum ada, sambil OpenNew selalu membuka URL-nya di jendela yang baru dibuat.
Properti
Document |
Mendapatkan dokumen HTML yang terkandung dalam jendela. |
DomWindow |
Mendapatkan antarmuka yang tidak terkelola yang dibungkus oleh kelas ini. |
Frames |
Mendapatkan referensi ke setiap elemen yang |
History |
Mendapatkan objek yang berisi URL pengguna yang terakhir dikunjungi. |
IsClosed |
Mendapatkan nilai yang menunjukkan apakah jendela ini terbuka atau tertutup. |
Name |
Mendapatkan atau mengatur nama jendela. |
Opener |
Mendapatkan referensi ke jendela yang membuka jendela saat ini. |
Parent |
Mendapatkan jendela yang berada di atas jendela saat ini dalam halaman yang berisi bingkai. |
Position |
Mendapatkan posisi area klien jendela di layar. |
Size |
Mendapatkan atau mengatur ukuran jendela saat ini. |
StatusBarText |
Mendapatkan atau mengatur teks yang ditampilkan di bilah status jendela. |
Url |
Mendapatkan URL yang sesuai dengan item saat ini yang ditampilkan di jendela. |
WindowFrameElement |
Mendapatkan elemen bingkai yang sesuai dengan jendela ini. |
Metode
Alert(String) |
Menampilkan kotak pesan. |
AttachEventHandler(String, EventHandler) |
Menambahkan penanganan aktivitas untuk peristiwa HTML DOM bernama. |
Close() |
Menutup jendela. |
Confirm(String) |
Menampilkan kotak dialog dengan pesan dan tombol untuk meminta respons ya/tidak. |
DetachEventHandler(String, EventHandler) |
Menghapus penanganan aktivitas bernama. |
Equals(Object) |
Menguji objek untuk kesetaraan terhadap objek saat ini. |
Focus() |
Memfokuskan pada jendela saat ini. |
GetHashCode() |
Berfungsi sebagai fungsi hash untuk jenis tertentu. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
MoveTo(Int32, Int32) |
Memindahkan jendela ke koordinat yang ditentukan pada layar. |
MoveTo(Point) |
Memindahkan jendela ke koordinat yang ditentukan pada layar. |
Navigate(String) |
Menampilkan atau mengunduh isi baru yang terletak pada URL yang ditentukan. |
Navigate(Uri) |
Menampilkan dokumen baru di jendela saat ini. |
Open(String, String, String, Boolean) |
Menampilkan file dalam jendela bernama. |
Open(Uri, String, String, Boolean) |
Menampilkan file dalam jendela bernama. |
OpenNew(String, String) |
Menampilkan file dalam jendela baru. |
OpenNew(Uri, String) |
Menampilkan file dalam jendela baru. |
Prompt(String, String) |
Memperlihatkan kotak dialog yang menampilkan pesan dan kotak teks kepada pengguna. |
RemoveFocus() |
Mengambil fokus dari jendela saat ini. |
ResizeTo(Int32, Int32) |
Mengubah ukuran jendela ke dimensi yang ditentukan. |
ResizeTo(Size) |
Mengubah ukuran jendela ke dimensi yang ditentukan. |
ScrollTo(Int32, Int32) |
Menggulir jendela ke posisi yang ditunjuk. |
ScrollTo(Point) |
Memindahkan jendela ke koordinat yang ditentukan. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Operator
Equality(HtmlWindow, HtmlWindow) |
Menguji dua HtmlWindow objek untuk kesetaraan. |
Inequality(HtmlWindow, HtmlWindow) |
Menguji dua |
Acara
Error |
Terjadi ketika skrip yang berjalan di dalam jendela mengalami kesalahan run-time. |
GotFocus |
Terjadi ketika jendela saat ini mendapatkan fokus input pengguna. |
Load |
Terjadi ketika dokumen jendela dan semua elemennya telah selesai diinisialisasi. |
LostFocus |
Terjadi ketika fokus input pengguna telah meninggalkan jendela. |
Resize |
Terjadi ketika pengguna menggunakan mouse untuk mengubah dimensi jendela. |
Scroll |
Terjadi ketika pengguna menggulir jendela untuk melihat teks di luar layar. |
Unload |
Terjadi ketika halaman saat ini sedang dibongkar, dan halaman baru akan ditampilkan. |