TreeNodeStates Enumeración

Definición

Define constantes que representan los posibles estados de TreeNode.Defines constants that represent the possible states of a TreeNode.

Esta enumeración tiene el atributo FlagsAttribute, que permite una combinación bit a bit de sus valores de miembro.

public enum class TreeNodeStates
[System.Flags]
public enum TreeNodeStates
type TreeNodeStates = 
Public Enum TreeNodeStates
Herencia
TreeNodeStates
Atributos

Campos

Checked 8

El nodo está activado.The node is checked.

Default 32

El nodo está en su estado predeterminado.The node is in its default state.

Focused 16

El nodo tiene foco.The node has focus.

Grayed 2

El nodo está deshabilitado.The node is disabled.

Hot 64

El nodo está caliente.The node is hot. Este estado aparece cuando la propiedad HotTracking se establece en true y el puntero del mouse está encima del nodo.This state occurs when the HotTracking property is set to true and the mouse pointer is over the node.

Indeterminate 256

Nodo en un estado indeterminado.The node in an indeterminate state.

Marked 128

El nodo está marcado.The node is marked.

Selected 1

El nodo está seleccionado.The node is selected.

ShowKeyboardCues 512

El nodo debe indicar un método abreviado de teclado.The node should indicate a keyboard shortcut.

Ejemplos

En el ejemplo siguiente se muestra cómo personalizar TreeView un control mediante el dibujo del propietario.The following example demonstrates how to customize a TreeView control using owner drawing. El TreeView control en el ejemplo muestra etiquetas de nodo opcionales junto con las etiquetas de nodo normales.The TreeView control in the example displays optional node tags alongside the normal node labels. Las etiquetas de nodo se especifican mediante la TreeNode.Tag propiedad.Node tags are specified using the TreeNode.Tag property. El TreeView control también utiliza colores personalizados, incluido un color de resaltado personalizado.The TreeView control also uses custom colors, including a custom highlight color.

Puede personalizar la mayoría de los TreeView colores estableciendo las propiedades de color, pero el color de resaltado de la selección no está disponible como una propiedad.You can customize most of the TreeView colors by setting color properties, but the selection highlight color is not available as a property. Además, el rectángulo de resaltado de selección predeterminado solo se extiende alrededor de una etiqueta de nodo.Additionally, the default selection highlight rectangle extends only around a node label. El dibujo del propietario debe utilizarse para dibujar las etiquetas de nodo y para dibujar un rectángulo de resaltado personalizado lo suficientemente grande como para incluir una etiqueta de nodo.Owner drawing must be used to draw the node tags and to draw a customized highlight rectangle large enough to include a node tag.

En el ejemplo, un controlador para el TreeView.DrawNode evento dibuja nodos no seleccionados llamando a métodos de la DrawTreeNodeEventArgs clase.In the example, a handler for the TreeView.DrawNode event draws unselected nodes by calling methods of the DrawTreeNodeEventArgs class. Estos métodos proporcionan la apariencia predeterminada de TreeView los elementos que no necesitan personalización.These methods provide the default appearance for TreeView elements that do not need customization. El controlador dibuja las etiquetas del nodo y el resaltado de la selección personalizada de forma manual.The handler draws the node tags and the custom selection highlight manually.

Para obtener el ejemplo completo, vea TreeView.DrawNode el tema de referencia.For the complete example, see the TreeView.DrawNode reference topic.

   // 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) != (TreeNodeStates)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.
         System::Drawing::Font^ nodeFont = e->Node->NodeFont;
         if ( nodeFont == nullptr )
                  nodeFont = (dynamic_cast<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 != nullptr )
      {
         e->Graphics->DrawString( e->Node->Tag->ToString(), tagFont, Brushes::Yellow, (float)e->Bounds.Right + 2, (float)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) != (TreeNodeStates)0 )
      {
         Pen^ focusPen = gcnew Pen( Color::Black );
         try
         {
            focusPen->DashStyle = System::Drawing::Drawing2D::DashStyle::Dot;
            Rectangle focusBounds = NodeBounds( e->Node );
            focusBounds.Size = System::Drawing::Size( focusBounds.Width - 1, focusBounds.Height - 1 );
            e->Graphics->DrawRectangle( focusPen, focusBounds );
         }
         finally
         {
            if ( focusPen )
               delete safe_cast<IDisposable^>(focusPen);
         }

      }
   }
// 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);
        }
    }
}
' Draws a node.
Private Sub myTreeView_DrawNode(ByVal sender As Object, _
    ByVal e As DrawTreeNodeEventArgs) Handles myTreeView.DrawNode

    ' Draw the background and node text for a selected node.
    If (e.State And TreeNodeStates.Selected) <> 0 Then

        ' 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.
        Dim nodeFont As Font = e.Node.NodeFont
        If nodeFont Is Nothing Then
            nodeFont = CType(sender, TreeView).Font
        End If

        ' Draw the node text.
        e.Graphics.DrawString(e.Node.Text, nodeFont, Brushes.White, _
            e.Bounds.Left - 2, e.Bounds.Top)

    ' Use the default background and node text.
    Else
        e.DrawDefault = True
    End If

    ' If a node tag is present, draw its string representation 
    ' to the right of the label text.
    If (e.Node.Tag IsNot Nothing) Then
        e.Graphics.DrawString(e.Node.Tag.ToString(), tagFont, _
            Brushes.Yellow, e.Bounds.Right + 2, e.Bounds.Top)
    End If

    ' 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 And TreeNodeStates.Focused) <> 0 Then
        Dim focusPen As New Pen(Color.Black)
        Try
            focusPen.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot
            Dim focusBounds As Rectangle = NodeBounds(e.Node)
            focusBounds.Size = New Size(focusBounds.Width - 1, _
                focusBounds.Height - 1)
            e.Graphics.DrawRectangle(focusPen, focusBounds)
        Finally
            focusPen.Dispose()
        End Try
    End If

End Sub

Comentarios

Esta enumeración la usa la State propiedad de la DrawTreeNodeEventArgs clase.This enumeration is used by the State property of the DrawTreeNodeEventArgs class. Para obtener más información, vea el evento TreeView.DrawNode.For more information, see the TreeView.DrawNode event.

Se aplica a

Consulte también: