TreeNode Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un nodo de TreeView.

public ref class TreeNode : MarshalByRefObject, ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TreeNodeConverter))]
[System.Serializable]
public class TreeNode : MarshalByRefObject, ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TreeNodeConverter))>]
[<System.Serializable>]
type TreeNode = class
    inherit MarshalByRefObject
    interface ICloneable
    interface ISerializable

Public Class TreeNode
Inherits MarshalByRefObject
Implements ICloneable, ISerializable

Herencia: Object

MarshalByRefObject
TreeNode

Derivado: System.ComponentModel.Design.ObjectSelectorEditor.SelectorNode

System.Workflow.ComponentModel.Design.WorkflowOutlineNode

Atributos: TypeConverterAttribute SerializableAttribute

Implementaciones: ICloneable ISerializable

Ejemplos

En el ejemplo de código siguiente se muestra la información del cliente en un TreeView control . Los nodos de árbol raíz muestran los nombres de cliente y los nodos de árbol secundarios muestran los números de pedido asignados a cada cliente. En este ejemplo, se muestran 1000 clientes con 15 pedidos cada uno. La reintentos de TreeView se suprime mediante los BeginUpdate métodos y EndUpdate , y se muestra una espera Cursor mientras TreeView crea y pinta los TreeNode objetos. Este ejemplo requiere que tenga un Customer objeto que pueda contener una colección de Order objetos . También requiere que haya creado una instancia de un TreeView control en .Form

// The basic Customer class.
ref class Customer: public System::Object
{
private:
   String^ custName;

protected:
   ArrayList^ custOrders;

public:
   Customer( String^ customername )
   {
      custName = "";
      custOrders = gcnew ArrayList;
      this->custName = customername;
   }


   property String^ CustomerName 
   {
      String^ get()
      {
         return this->custName;
      }

      void set( String^ value )
      {
         this->custName = value;
      }

   }

   property ArrayList^ CustomerOrders 
   {
      ArrayList^ get()
      {
         return this->custOrders;
      }

   }

};


// End Customer class
// The basic customer Order class.
ref class Order: public System::Object
{
private:
   String^ ordID;

public:
   Order( String^ orderid )
   {
      ordID = "";
      this->ordID = orderid;
   }


   property String^ OrderID 
   {
      String^ get()
      {
         return this->ordID;
      }

      void set( String^ value )
      {
         this->ordID = value;
      }

   }

};
// End Order class



void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for ( int x = 0; x < 1000; x++ )
   {
      customerArray->Add( gcnew Customer( "Customer " + x ) );
   }
   
   // Add orders to each Customer object in the ArrayList.
   IEnumerator^ myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer1 = safe_cast<Customer^>(myEnum->Current);
      for ( int y = 0; y < 15; y++ )
      {
         customer1->CustomerOrders->Add( gcnew Order( "Order " + y ) );
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   ::Cursor::Current = gcnew System::Windows::Forms::Cursor( "MyWait.cur" );
   
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1->BeginUpdate();
   
   // Clear the TreeView each time the method is called.
   treeView1->Nodes->Clear();
   
   // Add a root TreeNode for each Customer object in the ArrayList.
   myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ customer2 = safe_cast<Customer^>(myEnum->Current);
      treeView1->Nodes->Add( gcnew TreeNode( customer2->CustomerName ) );
      
      // Add a child treenode for each Order object in the current Customer object.
      IEnumerator^ myEnum = customer2->CustomerOrders->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Order^ order1 = safe_cast<Order^>(myEnum->Current);
         treeView1->Nodes[ customerArray->IndexOf( customer2 ) ]->Nodes->Add( gcnew TreeNode( customer2->CustomerName + "." + order1->OrderID ) );
      }
   }
   
   // Reset the cursor to the default for all controls.
   ::Cursor::Current = Cursors::Default;
   
   // Begin repainting the TreeView.
   treeView1->EndUpdate();
}


// The basic Customer class.
public class Customer : System.Object
{
   private string custName = "";
   protected ArrayList custOrders = new ArrayList();

   public Customer(string customername)
   {
      this.custName = customername;
   }

   public string CustomerName
   {      
      get{return this.custName;}
      set{this.custName = value;}
   }

   public ArrayList CustomerOrders 
   {
      get{return this.custOrders;}
   }
} // End Customer class 

// The basic customer Order class.
public class Order : System.Object
{
   private string ordID = "";

   public Order(string orderid)
   {
      this.ordID = orderid;
   }

   public string OrderID
   {      
      get{return this.ordID;}
      set{this.ordID = value;}
   }
} // End Order class

// Create a new ArrayList to hold the Customer objects.
private ArrayList customerArray = new ArrayList(); 

private void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for(int x=0; x<1000; x++)
   {
      customerArray.Add(new Customer("Customer" + x.ToString()));
   }

   // Add orders to each Customer object in the ArrayList.
   foreach(Customer customer1 in customerArray)
   {
      for(int y=0; y<15; y++)
      {
         customer1.CustomerOrders.Add(new Order("Order" + y.ToString()));    
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = new Cursor("MyWait.cur");
        
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate();

   // Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear();

   // Add a root TreeNode for each Customer object in the ArrayList.
   foreach(Customer customer2 in customerArray)
   {
      treeView1.Nodes.Add(new TreeNode(customer2.CustomerName));
          
      // Add a child treenode for each Order object in the current Customer object.
      foreach(Order order1 in customer2.CustomerOrders)
      {
         treeView1.Nodes[customerArray.IndexOf(customer2)].Nodes.Add(
           new TreeNode(customer2.CustomerName + "." + order1.OrderID));
      }
   }

   // Reset the cursor to the default for all controls.
   Cursor.Current = Cursors.Default;

   // Begin repainting the TreeView.
   treeView1.EndUpdate();
}

Public Class Customer
   Inherits [Object]
   Private custName As String = ""
   Friend custOrders As New ArrayList()

   Public Sub New(ByVal customername As String)
      Me.custName = customername
   End Sub

   Public Property CustomerName() As String
      Get
         Return Me.custName
      End Get
      Set(ByVal Value As String)
         Me.custName = Value
      End Set
   End Property

   Public ReadOnly Property CustomerOrders() As ArrayList
      Get
         Return Me.custOrders
      End Get
   End Property
End Class


Public Class Order
   Inherits [Object]
   Private ordID As String

   Public Sub New(ByVal orderid As String)
      Me.ordID = orderid
   End Sub

   Public Property OrderID() As String
      Get
         Return Me.ordID
      End Get
      Set(ByVal Value As String)
         Me.ordID = Value
      End Set
   End Property
End Class

' Create a new ArrayList to hold the Customer objects.
Private customerArray As New ArrayList()

Private Sub FillMyTreeView()
   ' Add customers to the ArrayList of Customer objects.
   Dim x As Integer
   For x = 0 To 999
      customerArray.Add(New Customer("Customer" + x.ToString()))
   Next x

   ' Add orders to each Customer object in the ArrayList.
   Dim customer1 As Customer
   For Each customer1 In customerArray
      Dim y As Integer
      For y = 0 To 14
         customer1.CustomerOrders.Add(New Order("Order" + y.ToString()))
      Next y
   Next customer1

   ' Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = New Cursor("MyWait.cur")

   ' Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate()

   ' Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear()

   ' Add a root TreeNode for each Customer object in the ArrayList.
   Dim customer2 As Customer
   For Each customer2 In customerArray
      treeView1.Nodes.Add(New TreeNode(customer2.CustomerName))

      ' Add a child TreeNode for each Order object in the current Customer object.
      Dim order1 As Order
      For Each order1 In customer2.CustomerOrders
         treeView1.Nodes(customerArray.IndexOf(customer2)).Nodes.Add( _
    New TreeNode(customer2.CustomerName + "." + order1.OrderID))
      Next order1
   Next customer2

   ' Reset the cursor to the default for all controls.
   Cursor.Current = System.Windows.Forms.Cursors.Default

   ' Begin repainting the TreeView.
   treeView1.EndUpdate()
End Sub

Comentarios

La Nodes colección contiene todos los objetos secundarios TreeNode asignados al objeto actual TreeNode. Puede agregar, quitar o clonar un TreeNodeelemento ; al hacerlo, se agregan, quitan o clonan todos los nodos de árbol secundarios. Cada TreeNode uno puede contener una colección de otros TreeNode objetos. Esto puede dificultar la determinación de dónde se encuentra al TreeView recorrer en iteración la colección. Para determinar la ubicación en una estructura de árbol, use la FullPath propiedad . La FullPath cadena se puede analizar mediante el valor de PathSeparator cadena para determinar dónde comienza y termina una TreeNode etiqueta.

La TreeNode etiqueta se establece estableciendo la Text propiedad explícitamente. La alternativa es crear el nodo de árbol mediante uno de los TreeNode constructores que tiene un parámetro de cadena que representa la Text propiedad . La etiqueta se muestra junto a la TreeNode imagen, si se muestra una.

Para mostrar imágenes junto a los nodos de árbol, asigne un ImageList a la ImageList propiedad del control primario TreeView y asígnele un Image haciendo referencia a su valor de índice en la ImageList propiedad . Establezca la ImageIndex propiedad en el valor de índice del que Image desea mostrar cuando TreeNode el objeto está en un estado no seleccionado. Del mismo modo, establezca la SelectedImageIndex propiedad en el valor de índice del que Image desea mostrar cuando se selecciona .TreeNode

La selección de nodos de árbol específicos y la iteración a través de la Nodes colección se pueden lograr mediante los siguientes valores de propiedad: FirstNode, , LastNode NextNode, PrevNode, NextVisibleNode, . PrevVisibleNode Asigne el TreeNode devuelto por una de las propiedades mencionadas anteriormente a la TreeView.SelectedNode propiedad para seleccionar ese nodo de árbol en el TreeView control.

Los nodos de árbol se pueden expandir para mostrar el siguiente nivel de nodos de árbol secundarios. El usuario puede expandir TreeNode presionando el botón más (+) situado junto a TreeNode, si se muestra uno o puede expandir TreeNode llamando al Expand método . Para expandir todos los niveles de nodo de árbol secundarios de la Nodes colección, llame al ExpandAll método . Puede contraer el TreeNode nivel secundario llamando al Collapse método o el usuario puede presionar el botón menos (-) situado junto a TreeNode, si se muestra uno. También puede llamar al Toggle método para alternar entre TreeNode los estados expandidos y contraídos.

Opcionalmente, los nodos de árbol pueden mostrar una casilla. Para mostrar las casillas, establezca la CheckBoxes propiedad de en TreeViewtrue. La Checked propiedad se establece true en para los nodos de árbol que están en un estado comprobado.

Constructores

TreeNode()	Inicializa una nueva instancia de la clase TreeNode.
TreeNode(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la clase TreeNode con la información de serialización y el contexto especificados.
TreeNode(String)	Inicializa una nueva instancia de la clase TreeNode con el texto de etiqueta especificado.
TreeNode(String, Int32, Int32)	Inicializa una nueva instancia de la clase TreeNode con el texto de etiqueta especificado y las imágenes que se han de mostrar cuando el nodo de árbol esté seleccionado o sin seleccionar.
TreeNode(String, Int32, Int32, TreeNode[])	Inicializa una nueva instancia de la clase TreeNode con el texto de etiqueta, los nodos de árbol secundarios y las imágenes que se han especificado y se han de mostrar cuando el nodo de árbol esté seleccionado o sin seleccionar.
TreeNode(String, TreeNode[])	Inicializa una nueva instancia de la clase TreeNode con el texto de etiqueta y los nodos de árbol secundarios especificados.

Propiedades

BackColor	Obtiene o establece el color de fondo del nodo de árbol.
Bounds	Obtiene los límites del nodo de árbol.
Checked	Obtiene o establece un valor que indica si el nodo de árbol está activado.
ContextMenu	Obtiene o establece el menú contextual asociado a este nodo de árbol.
ContextMenuStrip	Obtiene o establece el menú contextual asociado a este nodo de árbol.
FirstNode	Obtiene el primer nodo de árbol secundario en la colección de nodos de árbol.
ForeColor	Obtiene o establece el color de primer plano del nodo de árbol.
FullPath	Obtiene la ruta de acceso desde el nodo de árbol raíz hasta el actual nodo de árbol.
Handle	Obtiene el identificador del nodo de árbol.
ImageIndex	Obtiene o establece el valor de índice de la lista de imágenes correspondiente a la imagen que se muestra cuando no está seleccionado el nodo de árbol.
ImageKey	Obtiene o establece la clave para la imagen asociada a este nodo de árbol cuando el nodo está en un estado no seleccionado.
Index	Obtiene la posición del nodo de árbol en la colección de nodos de árbol.
IsEditing	Obtiene un valor que indica si el nodo de árbol es editable.
IsExpanded	Obtiene un valor que indica si el nodo de árbol está expandido.
IsSelected	Obtiene un valor que indica si el nodo de árbol está seleccionado.
IsVisible	Obtiene un valor que indica si el nodo de árbol está visible o parcialmente visible.
LastNode	Obtiene el último nodo de árbol secundario.
Level	Obtiene la profundidad basada en cero del nodo de árbol en el control TreeView.
Name	Obtiene o establece el nombre de árbol.
NextNode	Obtiene el siguiente nodo de árbol relacionado.
NextVisibleNode	Obtiene el siguiente nodo de árbol visible.
NodeFont	Obtiene o establece la fuente que se usa para mostrar el texto en la etiqueta del nodo de árbol.
Nodes	Obtiene la colección de objetos TreeNode asignados al actual nodo de árbol.
Parent	Obtiene el nodo de árbol primario del actual nodo de árbol.
PrevNode	Obtiene el anterior nodo de árbol relacionado.
PrevVisibleNode	Obtiene el anterior nodo de árbol visible.
SelectedImageIndex	Obtiene o establece el valor de índice de la lista de imágenes correspondiente a la imagen que se muestra cuando está seleccionado el nodo de árbol.
SelectedImageKey	Obtiene o establece la clave de la imagen mostrada en el nodo de árbol cuando está seleccionado.
StateImageIndex	Obtiene o establece el índice de la imagen que se usa para indicar el estado del TreeNode cuando el TreeView primario tiene su propiedad CheckBoxes establecida en `false`.
StateImageKey	Obtiene o establece la clave de la imagen que se usa para indicar el estado del TreeNode cuando el TreeView primario tiene su propiedad CheckBoxes establecida en `false`.
Tag	Obtiene o establece el objeto que contiene datos acerca del nodo de árbol.
Text	Obtiene o establece el texto que se muestra en la etiqueta del nodo de árbol.
ToolTipText	Obtiene o establece el texto que aparece cuando el puntero del mouse se desplaza sobre el control TreeNode.
TreeView	Obtiene la vista de árbol primaria a la que está asignado el nodo de árbol.

Métodos

BeginEdit()	Inicia la edición de la etiqueta del nodo de árbol.
Clone()	Copia el nodo de árbol y todo el subárbol con raíz en este nodo de árbol.
Collapse()	Contrae el nodo de árbol.
Collapse(Boolean)	Contrae el control TreeNode y opcionalmente contrae sus elementos secundarios.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Deserialize(SerializationInfo, StreamingContext)	Carga el estado del TreeNode a partir del SerializationInfo especificado.
EndEdit(Boolean)	Finaliza la edición de la etiqueta del nodo de árbol.
EnsureVisible()	Garantiza que el nodo de árbol sea visible, mediante la expansión de los nodos de árbol y el desplazamiento por el control de vista de árbol según sea necesario.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Expand()	Expande el nodo de árbol.
ExpandAll()	Expande todos los nodos de árbol secundarios.
FromHandle(TreeView, IntPtr)	Devuelve el nodo de árbol que tiene el identificador especificado y que está asignado al control de vista de árbol especificado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetNodeCount(Boolean)	Devuelve el número de nodos de árbol secundarios.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Remove()	Quita el actual nodo de árbol del control de vista de árbol.
Serialize(SerializationInfo, StreamingContext)	Guarda el estado del TreeNode en el SerializationInfo especificado.
Toggle()	Alterna el estado del nodo de árbol entre expandido y contraído.
ToString()	Devuelve una cadena que representa el objeto actual.

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena un objeto de información de serialización con los datos necesarios para serializar TreeNode.

Se aplica a

Compartir a través de

TreeNode Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales