HtmlWindow Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

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

Object

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 FRAME ditentukan dalam halaman Web.
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 HtmlWindow objek untuk ketidaksamaan.

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.

Lihat juga

• objek jendela
• Antarmuka IHTMLWindow2