DrawTreeNodeEventArgs.Node Proprietà

Definizione

Ottiene l'oggetto TreeNode da disegnare.

public System.Windows.Forms.TreeNode Node { get; }
public System.Windows.Forms.TreeNode? Node { get; }

Valore della proprietà

Classe TreeNode da disegnare.

Esempio

Nell'esempio di codice seguente viene illustrato come personalizzare un controllo utilizzando il TreeView disegno del proprietario. Il TreeView controllo nell'esempio visualizza i tag di nodo facoltativi insieme alle etichette dei nodi standard. I tag dei nodi vengono specificati usando la TreeNode.Tag proprietà . Il TreeView controllo usa anche colori personalizzati, incluso un colore di evidenziazione personalizzato.

È possibile personalizzare la maggior parte dei TreeView colori impostando le proprietà dei colori, ma il colore di evidenziazione della selezione non è disponibile come proprietà. Inoltre, il rettangolo di evidenziazione della selezione predefinita si estende solo intorno a un'etichetta del nodo. Il disegno proprietario deve essere utilizzato per disegnare i tag del nodo e per disegnare un rettangolo di evidenziazione personalizzato sufficientemente grande da includere un tag di nodo.

Nell'esempio, un gestore per l'evento TreeView.DrawNode disegna manualmente i tag del nodo e l'evidenziazione della selezione personalizzata. I nodi non selezionati non richiedono la personalizzazione. Per questi, la DrawDefault proprietà è impostata su true in modo che vengano disegnate dal sistema operativo.

Per l'esempio completo, vedere l'argomento di DrawTreeNodeEventArgs riferimento di panoramica.

// Draws a node.
private void myTreeView_DrawNode(
    object sender, DrawTreeNodeEventArgs e)
{
    // Draw the background and node text for a selected node.
    if ((e.State & TreeNodeStates.Selected) != 0)
    {
        // Draw the background of the selected node. The NodeBounds
        // method makes the highlight rectangle large enough to
        // include the text of a node tag, if one is present.
        e.Graphics.FillRectangle(Brushes.Green, NodeBounds(e.Node));

        // Retrieve the node font. If the node font has not been set,
        // use the TreeView font.
        Font nodeFont = e.Node.NodeFont;
        if (nodeFont == null) nodeFont = ((TreeView)sender).Font;

        // Draw the node text.
        e.Graphics.DrawString(e.Node.Text, nodeFont, Brushes.White,
            Rectangle.Inflate(e.Bounds, 2, 0));
    }

    // Use the default background and node text.
    else 
    {
        e.DrawDefault = true;
    }

    // If a node tag is present, draw its string representation 
    // to the right of the label text.
    if (e.Node.Tag != null)
    {
        e.Graphics.DrawString(e.Node.Tag.ToString(), tagFont,
            Brushes.Yellow, e.Bounds.Right + 2, e.Bounds.Top);
    }

    // If the node has focus, draw the focus rectangle large, making
    // it large enough to include the text of the node tag, if present.
    if ((e.State & TreeNodeStates.Focused) != 0)
    {
        using (Pen focusPen = new Pen(Color.Black))
        {
            focusPen.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot;
            Rectangle focusBounds = NodeBounds(e.Node);
            focusBounds.Size = new Size(focusBounds.Width - 1, 
            focusBounds.Height - 1);
            e.Graphics.DrawRectangle(focusPen, focusBounds);
        }
    }
}

Commenti

Utilizzare questa proprietà per accedere all'oggetto TreeNode da disegnare. Ciò è utile quando la State proprietà non fornisce informazioni adeguate per soddisfare le proprie esigenze. La State proprietà fornisce solo informazioni sullo stato di base che è possibile usare, ad esempio, per determinare se un nodo è selezionato, controllato o attivo. La Node proprietà, invece, consente di accedere a tutti i membri dell'oggetto TreeNode . È necessario accedere direttamente al nodo, ad esempio, quando si vuole determinarne lo stato di espansione.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Vedi anche