HtmlElement Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

HtmlElement.cs

Mewakili elemen HTML di dalam halaman Web.

public ref class HtmlElement sealed

public sealed class HtmlElement

type HtmlElement = class

Public NotInheritable Class HtmlElement

Warisan

Object

HtmlElement

Contoh

Contoh kode berikut menunjukkan cara memeriksa dokumen HTML arbitrer dan mendapatkan string yang menjelaskan elemen HTML, dengan indentasi dan angka tingkat yang digunakan untuk menunjukkan seberapa dalam elemen disarangkan dalam dokumen. Contoh kode ini mengharuskan aplikasi Anda menghosting WebBrowser kontrol bernama WebBrowser1.

private void PrintDomBegin()
{
    if (webBrowser1.Document != null)
    {
        HtmlElementCollection elemColl = null;
        HtmlDocument doc = webBrowser1.Document;
        if (doc != null)
        {
            elemColl = doc.GetElementsByTagName("HTML");
            String str = PrintDom(elemColl, new System.Text.StringBuilder(), 0);
            webBrowser1.DocumentText = str;
        }
    }
}

private string PrintDom(HtmlElementCollection elemColl, System.Text.StringBuilder returnStr, Int32 depth)
{
    System.Text.StringBuilder str = new System.Text.StringBuilder();

    foreach (HtmlElement elem in elemColl)
    {
        string elemName;

        elemName = elem.GetAttribute("ID");
        if (elemName == null || elemName.Length == 0)
        {
            elemName = elem.GetAttribute("name");
            if (elemName == null || elemName.Length == 0)
            {
                elemName = "<no name>";
            }
        }

        str.Append(' ', depth * 4);
        str.Append(elemName + ": " + elem.TagName + "(Level " + depth + ")");
        returnStr.AppendLine(str.ToString());

        if (elem.CanHaveChildren)
        {
            PrintDom(elem.Children, returnStr, depth + 1);
        }

        str.Remove(0, str.Length);
    }

    return (returnStr.ToString());
}

Private Sub PrintDomBegin()
    If (WebBrowser1.Document IsNot Nothing) Then
        Dim ElemColl As HtmlElementCollection

        Dim Doc As HtmlDocument = WebBrowser1.Document
        If (Not (Doc Is Nothing)) Then
            ElemColl = Doc.GetElementsByTagName("HTML")
            Dim Str As String = PrintDom(ElemColl, New System.Text.StringBuilder(), 0)

            WebBrowser1.DocumentText = Str
        End If
    End If
End Sub

Private Function PrintDom(ByVal ElemColl As HtmlElementCollection, ByRef ReturnStr As System.Text.StringBuilder, ByVal Depth As Integer) As String
    Dim Str As New System.Text.StringBuilder()

    For Each Elem As HtmlElement In ElemColl
        Dim ElemName As String

        ElemName = Elem.GetAttribute("ID")
        If (ElemName Is Nothing Or ElemName.Length = 0) Then
            ElemName = Elem.GetAttribute("name")
            If (ElemName Is Nothing Or ElemName.Length = 0) Then
                ElemName = "<no name>"
            End If
        End If

        Str.Append(CChar(" "), Depth * 4)
        Str.Append(ElemName & ": " & Elem.TagName & "(Level " & Depth & ")")
        ReturnStr.AppendLine(Str.ToString())

        If (Elem.CanHaveChildren) Then
            PrintDom(Elem.Children, ReturnStr, Depth + 1)
        End If

        Str.Remove(0, Str.Length)
    Next

    PrintDom = ReturnStr.ToString()
End Function

Keterangan

HtmlElement mewakili jenis elemen yang mungkin dalam dokumen HTML, seperti BODY, , TABLEdan FORM, antara lain. Kelas ini mengekspos properti paling umum yang dapat Anda temukan di semua elemen.

Sebagian besar elemen dapat memiliki elemen turunan: elemen HTML lain yang ditempatkan di bawahnya. CanHaveChildren Gunakan properti untuk menguji apakah elemen tertentu memiliki anak, dan koleksi untuk melakukan iterasi melalui elemen tersebutChildren. Properti Parent mengembalikan HtmlElement tempat elemen saat ini ditumpuk.

Anda sering memerlukan akses ke atribut, properti, dan metode pada elemen dasar yang tidak langsung diekspos oleh HtmlElement, seperti SRC atribut pada IMG elemen atau Submit metode pada FORM. Metode GetAttribute dan SetAttribute memungkinkan Anda untuk mengambil dan mengubah atribut atau properti apa pun pada elemen tertentu, sambil InvokeMember menyediakan akses ke metode apa pun yang tidak diekspos dalam Model Objek Dokumen (DOM) terkelola. Jika aplikasi Anda memiliki izin kode yang tidak dikelola, Anda juga dapat mengakses properti dan metode yang tidak terekspos dengan DomElement atribut .

TagName Gunakan properti untuk menguji apakah elemen memiliki jenis tertentu.

Dokumen HTML apa pun dapat dimodifikasi pada waktu proses. Anda dapat membuat objek baru HtmlElement dengan CreateElement metode HtmlDocument, dan menambahkannya ke elemen lain menggunakan AppendChild metode atau InsertAdjacentElement . Anda juga dapat membuat elemen sebagai tag HTML dan menetapkannya ke properti elemen InnerHtml yang ada.

Properti

Nama	Deskripsi
All	HtmlElementCollection Mendapatkan dari semua elemen di bawah elemen saat ini.
CanHaveChildren	Mendapatkan nilai yang menunjukkan apakah elemen ini dapat memiliki elemen turunan.
Children	HtmlElementCollection Mendapatkan dari semua anak dari elemen saat ini.
ClientRectangle	Mendapatkan batas area klien dari elemen dalam dokumen HTML.
Document	Mendapatkan tempat HtmlDocument elemen ini berada.
DomElement	Mendapatkan penunjuk antarmuka yang tidak dikelola untuk elemen ini.
Enabled	Mendapatkan atau mengatur apakah pengguna dapat memasukkan data ke dalam elemen ini.
FirstChild	Mendapatkan elemen berikutnya di bawah elemen ini di pohon dokumen.
Id	Mendapatkan atau mengatur label untuk mengidentifikasi elemen.
InnerHtml	Mendapatkan atau mengatur markup HTML di bawah elemen ini.
InnerText	Mendapatkan atau mengatur teks yang ditetapkan ke elemen .
Name	Mendapatkan atau mengatur nama elemen.
NextSibling	Mendapatkan elemen berikutnya pada tingkat yang sama dengan elemen ini di pohon dokumen.
OffsetParent	Mendapatkan elemen dari yang OffsetRectangle dihitung.
OffsetRectangle	Mendapatkan lokasi elemen yang relatif terhadap induknya.
OuterHtml	Mendapatkan atau mengatur kode HTML elemen saat ini.
OuterText	Mendapatkan atau mengatur teks elemen saat ini.
Parent	Mendapatkan elemen induk elemen saat ini.
ScrollLeft	Mendapatkan atau mengatur jarak antara tepi elemen dan tepi kiri kontennya.
ScrollRectangle	Mendapatkan dimensi wilayah yang dapat digulir elemen.
ScrollTop	Mendapatkan atau mengatur jarak antara tepi elemen dan tepi atas kontennya.
Style	Mendapatkan atau mengatur daftar gaya yang dibatasi titik koma untuk elemen saat ini.
TabIndex	Mendapatkan atau mengatur lokasi elemen ini dalam urutan tab.
TagName	Mendapatkan nama tag HTML.

Metode

Nama	Deskripsi
AppendChild(HtmlElement)	Menambahkan elemen ke subtree elemen lain.
AttachEventHandler(String, EventHandler)	Menambahkan penanganan aktivitas untuk peristiwa bernama pada Model Objek Dokumen HTML (DOM).
DetachEventHandler(String, EventHandler)	Menghapus penanganan aktivitas dari peristiwa bernama pada Model Objek Dokumen HTML (DOM).
Equals(Object)	Menguji apakah objek yang disediakan sama dengan elemen saat ini.
Focus()	Menempatkan fokus input pengguna pada elemen saat ini.
GetAttribute(String)	Mengambil nilai atribut bernama pada elemen .
GetElementsByTagName(String)	Mengambil kumpulan elemen yang diwakili dalam HTML oleh tag yang ditentukan HTML .
GetHashCode()	Berfungsi sebagai fungsi hash untuk jenis tertentu.
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)	Sisipkan elemen baru ke dalam Model Objek Dokumen (DOM).
InvokeMember(String, Object[])	Menjalankan fungsi yang ditentukan dalam halaman HTML saat ini oleh bahasa skrip.
InvokeMember(String)	Menjalankan metode yang tidak terekspos pada elemen DOM yang mendasar dari elemen ini.
RaiseEvent(String)	Menyebabkan peristiwa bernama memanggil semua penanganan aktivitas terdaftar.
RemoveFocus()	Menghapus fokus dari elemen saat ini, jika elemen tersebut memiliki fokus.
ScrollIntoView(Boolean)	Menggulir dokumen yang berisi elemen ini hingga tepi atas atau bawah elemen ini selaras dengan jendela dokumen.
SetAttribute(String, String)	Mengatur nilai atribut bernama pada elemen .

Operator

Nama	Deskripsi
Equality(HtmlElement, HtmlElement)	Membandingkan dua elemen untuk kesetaraan.
Inequality(HtmlElement, HtmlElement)	Membandingkan dua HtmlElement objek untuk ketidaksamaan.

Acara

Nama	Deskripsi
Click	Terjadi ketika pengguna mengklik elemen dengan tombol mouse kiri.
DoubleClick	Terjadi ketika pengguna mengklik tombol mouse kiri di atas elemen dua kali, berturut-turut dengan cepat.
Drag	Terjadi saat pengguna menyeret teks ke berbagai lokasi.
DragEnd	Terjadi ketika pengguna menyelesaikan operasi seret.
DragLeave	Terjadi ketika pengguna tidak lagi menyeret item di atas elemen ini.
DragOver	Terjadi saat pengguna menyeret teks ke elemen .
Focusing	Terjadi ketika elemen pertama kali menerima fokus input pengguna.
GotFocus	Terjadi ketika elemen telah menerima fokus input pengguna.
KeyDown	Terjadi ketika pengguna menekan tombol pada keyboard.
KeyPress	Terjadi ketika pengguna menekan dan melepaskan tombol pada keyboard.
KeyUp	Terjadi ketika pengguna merilis kunci pada keyboard.
LosingFocus	Terjadi ketika elemen kehilangan fokus input pengguna.
LostFocus	Terjadi ketika elemen telah kehilangan fokus input pengguna.
MouseDown	Terjadi ketika pengguna menekan tombol mouse.
MouseEnter	Terjadi ketika pengguna pertama kali memindahkan kursor mouse di atas elemen saat ini.
MouseLeave	Terjadi ketika pengguna memindahkan kursor mouse dari elemen saat ini.
MouseMove	Terjadi ketika pengguna memindahkan kursor mouse di seluruh elemen.
MouseOver	Terjadi ketika kursor mouse memasuki batas elemen.
MouseUp	Terjadi ketika pengguna merilis tombol mouse.

Lihat juga

• Antarmuka IHTMLElement
• Antarmuka IHTMLElement2
• Antarmuka IHTMLElement3
• Antarmuka IHTMLElement4