TreeViewDrawMode Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Définit des constantes qui représentent les méthodes permettant de dessiner un TreeView.

C#

public enum TreeViewDrawMode

Héritage

Object

ValueType

Enum

TreeViewDrawMode

Champs

Nom	Valeur	Description
Normal	0	TreeView est dessiné par le système d'exploitation.
OwnerDrawAll	2	Tous les éléments d'un nœud TreeView sont dessinés manuellement, notamment les icônes, les cases à cocher, les signes plus et moins, et les lignes qui connectent les nœuds.
OwnerDrawText	1	La partie de l'étiquette des nœuds TreeView est dessinée manuellement. D'autres éléments de nœud sont dessinés par le système d'exploitation, notamment les icônes, les cases à cocher, les signes plus et moins, et les lignes qui connectent les nœuds.

Exemples

L’exemple de code suivant montre comment personnaliser un TreeView contrôle à l’aide de sa fonctionnalité de dessin du propriétaire. Le TreeView contrôle de l’exemple affiche des balises de nœud facultatives à côté des étiquettes de nœud standard. Les balises de nœud sont spécifiées à l’aide de la TreeNode.Tag propriété . Le TreeView contrôle utilise également des couleurs personnalisées, y compris une couleur de surbrillance personnalisée.

Vous pouvez personnaliser la plupart des couleurs en définissant des TreeView propriétés de couleur, mais la couleur de surbrillance de sélection n’est pas disponible en tant que propriété. En outre, le rectangle de sélection par défaut s’étend uniquement autour d’une étiquette de nœud. Le dessin propriétaire doit être utilisé pour dessiner les balises de nœud et dessiner un rectangle de surbrillance personnalisé suffisamment grand pour inclure une balise de nœud.

Pour obtenir l’exemple complet, consultez la rubrique de TreeView.DrawNode référence.

C#

public TreeViewOwnerDraw()
{
    // Create and initialize the TreeView control.
    myTreeView = new TreeView();
    myTreeView.Dock = DockStyle.Fill;
    myTreeView.BackColor = Color.Tan;
    myTreeView.CheckBoxes = true;

    // Add nodes to the TreeView control.
    TreeNode node;
    for (int x = 1; x < 4; ++x)
    {
        // Add a root node to the TreeView control.
        node = myTreeView.Nodes.Add(String.Format("Task {0}", x));
        for (int y = 1; y < 4; ++y)
        {
            // Add a child node to the root node.
            node.Nodes.Add(String.Format("Subtask {0}", y));
        }
    }
    myTreeView.ExpandAll();

    // Add tags containing alert messages to a few nodes 
    // and set the node background color to highlight them.
    myTreeView.Nodes[1].Nodes[0].Tag = "urgent!";
    myTreeView.Nodes[1].Nodes[0].BackColor = Color.Yellow;
    myTreeView.SelectedNode = myTreeView.Nodes[1].Nodes[0];
    myTreeView.Nodes[2].Nodes[1].Tag = "urgent!";
    myTreeView.Nodes[2].Nodes[1].BackColor = Color.Yellow;

    // Configure the TreeView control for owner-draw and add
    // a handler for the DrawNode event.
    myTreeView.DrawMode = TreeViewDrawMode.OwnerDrawText;
    myTreeView.DrawNode += 
        new DrawTreeNodeEventHandler(myTreeView_DrawNode);

    // Add a handler for the MouseDown event so that a node can be 
    // selected by clicking the tag text as well as the node text.
    myTreeView.MouseDown += new MouseEventHandler(myTreeView_MouseDown);

    // Initialize the form and add the TreeView control to it.
    this.ClientSize = new Size(292, 273);
    this.Controls.Add(myTreeView);
}

Remarques

Cette énumération est utilisée par la TreeView.DrawMode propriété pour indiquer si les nœuds ou les étiquettes de nœud d’un TreeView sont dessinés par le propriétaire. Pour plus d'informations, consultez l'événement TreeView.DrawNode.

S’applique à

Voir aussi

• TreeView
• DrawMode
• DrawNode