HtmlElement Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

HtmlElement.cs

Représente un élément HTML à l’intérieur d’une page Web.

public ref class HtmlElement sealed

public sealed class HtmlElement

type HtmlElement = class

Public NotInheritable Class HtmlElement

Héritage

Object

HtmlElement

Exemples

L’exemple de code suivant montre comment examiner un document HTML arbitraire et dériver une chaîne décrivant les éléments HTML, avec des nombres de retrait et de niveau utilisés pour indiquer la profondeur d’imbrication des éléments dans le document. Cet exemple de code nécessite que votre application héberge un WebBrowser contrôle nommé 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

Remarques

HtmlElement représente tout type d’élément possible dans un document HTML, tel que BODY, TABLEet FORM, entre autres. La classe expose les propriétés les plus courantes que vous pouvez rechercher sur tous les éléments.

La plupart des éléments peuvent avoir des éléments enfants : d’autres éléments HTML placés sous ces éléments. Utilisez la CanHaveChildren propriété pour tester si un élément donné a des enfants et la Children collection pour effectuer une itération à travers ces éléments. La Parent propriété retourne l’élément HtmlElement actuel imbriqué.

Vous avez souvent besoin d’accéder à des attributs, des propriétés et des méthodes sur l’élément sous-jacent qui ne sont pas directement exposés par HtmlElement, comme l’attribut SRC sur un IMG élément ou la Submit méthode sur un FORM. Les GetAttribute méthodes et SetAttribute les méthodes vous permettent de récupérer et de modifier n’importe quel attribut ou propriété sur un élément spécifique, tout en InvokeMember fournissant l’accès à toutes les méthodes non exposées dans le modèle DOM (Document Object Model) managé. Si votre application dispose d’une autorisation de code non managée, vous pouvez également accéder aux propriétés et méthodes non exposées avec l’attribut DomElement .

Utilisez la TagName propriété pour tester si un élément est d’un type spécifique.

Tout document HTML peut être modifié au moment de l’exécution. Vous pouvez créer des HtmlElement objets avec la CreateElement méthode de HtmlDocument, et les ajouter à un autre élément à l’aide des méthodes ou InsertAdjacentElement des AppendChild méthodes. Vous pouvez également créer les éléments en tant que balises HTML et les affecter à la propriété d’un InnerHtml élément existant.

Propriétés

Nom	Description
All	Obtient un HtmlElementCollection élément sous l’élément actuel.
CanHaveChildren	Obtient une valeur indiquant si cet élément peut avoir des éléments enfants.
Children	Obtient un HtmlElementCollection de tous les enfants de l’élément actuel.
ClientRectangle	Obtient les limites de la zone cliente de l’élément dans le document HTML.
Document	Obtient l’élément HtmlDocument auquel appartient cet élément.
DomElement	Obtient un pointeur d’interface non managé pour cet élément.
Enabled	Obtient ou définit si l’utilisateur peut entrer des données dans cet élément.
FirstChild	Obtient l’élément suivant sous cet élément dans l’arborescence de documents.
Id	Obtient ou définit une étiquette par laquelle identifier l’élément.
InnerHtml	Obtient ou définit le balisage HTML sous cet élément.
InnerText	Obtient ou définit le texte affecté à l’élément.
Name	Obtient ou définit le nom de l’élément.
NextSibling	Obtient l’élément suivant au même niveau que cet élément dans l’arborescence de documents.
OffsetParent	Obtient l’élément à partir duquel OffsetRectangle est calculé.
OffsetRectangle	Obtient l’emplacement d’un élément par rapport à son parent.
OuterHtml	Obtient ou définit le code HTML de l’élément actuel.
OuterText	Obtient ou définit le texte de l’élément actuel.
Parent	Obtient l’élément parent de l’élément actuel.
ScrollLeft	Obtient ou définit la distance entre le bord de l’élément et le bord gauche de son contenu.
ScrollRectangle	Obtient les dimensions de la région de défilement d’un élément.
ScrollTop	Obtient ou définit la distance entre le bord de l’élément et le bord supérieur de son contenu.
Style	Obtient ou définit une liste de styles délimitées par des points-virgules pour l’élément actif.
TabIndex	Obtient ou définit l’emplacement de cet élément dans l’ordre de tabulation.
TagName	Obtient le nom de la balise HTML.

Méthodes

Nom	Description
AppendChild(HtmlElement)	Ajoute un élément à la sous-arborescence d’un autre élément.
AttachEventHandler(String, EventHandler)	Ajoute un gestionnaire d’événements pour un événement nommé sur le modèle DOM (Document Object Model) HTML.
DetachEventHandler(String, EventHandler)	Supprime un gestionnaire d’événements d’un événement nommé sur le modèle DOM (Document Object Model) HTML.
Equals(Object)	Teste si l’objet fourni est égal à l’élément actuel.
Focus()	Place le focus d’entrée utilisateur sur l’élément actuel.
GetAttribute(String)	Récupère la valeur de l’attribut nommé sur l’élément.
GetElementsByTagName(String)	Récupère une collection d’éléments représentés en HTML par la balise spécifiée HTML .
GetHashCode()	Sert de fonction de hachage pour un type particulier.
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)	Insérez un nouvel élément dans le dom (Document Object Model).
InvokeMember(String, Object[])	Exécute une fonction définie dans la page HTML active par un langage de script.
InvokeMember(String)	Exécute une méthode non exposée sur l’élément DOM sous-jacent de cet élément.
RaiseEvent(String)	Provoque l’appel de tous les gestionnaires d’événements inscrits à l’événement.
RemoveFocus()	Supprime le focus de l’élément actuel, si cet élément a le focus.
ScrollIntoView(Boolean)	Fait défiler le document contenant cet élément jusqu’à ce que le bord supérieur ou inférieur de cet élément soit aligné sur la fenêtre du document.
SetAttribute(String, String)	Définit la valeur de l’attribut nommé sur l’élément.

Opérateurs

Nom	Description
Equality(HtmlElement, HtmlElement)	Compare deux éléments pour l’égalité.
Inequality(HtmlElement, HtmlElement)	Compare deux objets HtmlElement pour déterminer s'ils sont différents.

Événements

Nom	Description
Click	Se produit lorsque l’utilisateur clique sur l’élément avec le bouton gauche de la souris.
DoubleClick	Se produit lorsque l’utilisateur clique sur le bouton gauche de la souris sur un élément deux fois, en succession rapide.
Drag	Se produit lorsque l’utilisateur fait glisser du texte vers différents emplacements.
DragEnd	Se produit lorsqu’un utilisateur termine une opération de glissement.
DragLeave	Se produit lorsque l’utilisateur ne fait plus glisser un élément sur cet élément.
DragOver	Se produit lorsque l’utilisateur fait glisser du texte sur l’élément.
Focusing	Se produit lorsque l’élément reçoit d’abord le focus d’entrée utilisateur.
GotFocus	Se produit lorsque l’élément a reçu le focus d’entrée utilisateur.
KeyDown	Se produit lorsque l’utilisateur appuie sur une touche du clavier.
KeyPress	Se produit lorsque l’utilisateur appuie et relâche une touche sur le clavier.
KeyUp	Se produit lorsque l’utilisateur libère une touche sur le clavier.
LosingFocus	Se produit lorsque l’élément perd le focus d’entrée utilisateur.
LostFocus	Se produit lorsque l’élément a perdu le focus d’entrée utilisateur.
MouseDown	Se produit lorsque l’utilisateur appuie sur un bouton de la souris.
MouseEnter	Se produit lorsque l’utilisateur déplace d’abord le curseur de la souris sur l’élément actuel.
MouseLeave	Se produit lorsque l’utilisateur déplace le curseur de la souris hors de l’élément actuel.
MouseMove	Se produit lorsque l’utilisateur déplace le curseur de la souris sur l’élément.
MouseOver	Se produit lorsque le curseur de la souris entre les limites de l’élément.
MouseUp	Se produit lorsque l’utilisateur relâche un bouton de souris.

Voir aussi

• IHTMLElement, interface
• IHTMLElement2, interface
• IHTMLElement3, interface
• IHTMLElement4, interface