TreeNode.Text-Eigenschaft

Ruft den in der Bezeichnung des Strukturknotens angezeigten Text ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property Text As String
'Usage
Dim instance As TreeNode
Dim value As String

value = instance.Text

instance.Text = value

[LocalizableAttribute(true)] 
public string Text { get; set; }

[LocalizableAttribute(true)] 
public:
property String^ Text {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public function get Text () : String

public function set Text (value : String)

Eigenschaftenwert

Der in der Bezeichnung des Strukturknotens angezeigte Text.

Hinweise

Wenn die LabelEdit-Eigenschaft der übergeordneten TreeView auf false festgelegt ist, kann diese Eigenschaft nicht vom Benutzer festgelegt werden. Wenn diese Eigenschaft nicht explizit festgelegt werden soll, kann der Strukturknoten stattdessen mit einem der TreeNode-Konstruktoren erstellt werden, der einen Zeichenfolgeparameter enthält, der die Text-Eigenschaft darstellt. Die Bezeichnung wird neben dem TreeNode-Bild angezeigt, sofern ein Bild angezeigt wird.

Beispiel

Im folgenden Codebeispiel wird ein Stammknoten erstellt, dem untergeordnete Strukturknoten zugewiesen werden sollen. Dem Stammknoten wird ein untergeordneter Strukturknoten für jedes Customer-Objekt in einer ArrayList hinzugefügt. Außerdem wird dem Customer-Objekt ein untergeordneter Strukturknoten für jedes Order-Objekt zugeordnet. Das Customer-Objekt wird der Tag-Eigenschaft zugeordnet, und die Strukturknoten, die Customer-Objekte darstellen, werden in Orange-Text angezeigt. Für dieses Beispiel ist es erforderlich, dass ein Customer-Objekt und ein Order-Objekt definiert wurden und dass ein TreeView-Steuerelement in einem Form und eine ArrayList mit der Bezeichnung customerArray mit darin enthaltenen Customer-Objekten vorhanden sind.

Public Sub AddRootNodes()
   ' Add a root node to assign the customer nodes to.
   Dim rootNode As TreeNode
   rootNode = New TreeNode()
   rootNode.Text = "CustomerList"
   ' Add a main root treenode.
   myTreeView.Nodes.Add(rootNode)

   ' Add a root treenode for each Customer object in the ArrayList.
   Dim myCustomer As Customer
   For Each myCustomer In customerArray
      ' Add a child treenode for each Order object.
      Dim i As Integer = 0
      Dim myTreeNodeArray(4) As TreeNode
      Dim myOrder As Order
      For Each myOrder In  myCustomer.CustomerOrders
         myTreeNodeArray(i) = New TreeNode(myOrder.OrderID)
         i += 1
      Next myOrder
      Dim customerNode As New TreeNode(myCustomer.CustomerName, _
        myTreeNodeArray)
      ' Display the customer names with and Orange font.
      customerNode.ForeColor = Color.Orange
      ' Store the Customer object in the Tag property of the TreeNode.
      customerNode.Tag = myCustomer
      myTreeView.Nodes(0).Nodes.Add(customerNode)
   Next myCustomer
End Sub

public void AddRootNodes()
{
   // Add a root node to assign the customer nodes to.
   TreeNode rootNode = new TreeNode();
   rootNode.Text = "CustomerList";
   // Add a main root treenode.
   myTreeView.Nodes.Add(rootNode);

   // Add a root treenode for each 'Customer' object in the ArrayList.
   foreach(Customer myCustomer in customerArray)
   {
      // Add a child treenode for each Order object.
      int i = 0;
      TreeNode[] myTreeNodeArray = new TreeNode[5];
      foreach(Order myOrder in myCustomer.CustomerOrders)
      {
         myTreeNodeArray[i] = new TreeNode(myOrder.OrderID);
         i++;
      }
      TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
        myTreeNodeArray);
        // Display the customer names with and Orange font.
        customerNode.ForeColor = Color.Orange;
        // Store the Customer object in the Tag property of the TreeNode.
        customerNode.Tag = myCustomer;
      myTreeView.Nodes[0].Nodes.Add(customerNode);
   }
}

void AddRootNodes()
{
   
   // Add a root node to assign the customer nodes to.
   TreeNode^ rootNode = gcnew TreeNode;
   rootNode->Text = "CustomerList";
   
   // Add a main root treenode.
   myTreeView->Nodes->Add( rootNode );
   
   // Add a root treenode for each 'Customer' object in the ArrayList.
   IEnumerator^ myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ myCustomer = safe_cast<Customer^>(myEnum->Current);
      
      // Add a child treenode for each Order object.
      int i = 0;
      array<TreeNode^>^myTreeNodeArray = gcnew array<TreeNode^>(5);
      IEnumerator^ myEnum = myCustomer->CustomerOrders->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Order^ myOrder = safe_cast<Order^>(myEnum->Current);
         myTreeNodeArray[ i ] = gcnew TreeNode( myOrder->OrderID );
         i++;
      }
      TreeNode^ customerNode = gcnew TreeNode( myCustomer->CustomerName,myTreeNodeArray );
      
      // Display the customer names with and Orange font.
      customerNode->ForeColor = Color::Orange;
      
      // Store the Customer Object* in the Tag property of the TreeNode.
      customerNode->Tag = myCustomer;
      myTreeView->Nodes[ 0 ]->Nodes->Add( customerNode );
   }
}

public void AddRootNodes()
{
    // Add a root node to assign the customer nodes to.
    TreeNode rootNode = new TreeNode();
    rootNode.set_Text("CustomerList");
    // Add a main root treenode.
    myTreeView.get_Nodes().Add(rootNode);
    // Add a root treenode for each 'Customer' object in the ArrayList.
    for (int iCtr1 = 0; iCtr1 < customerArray.get_Count(); iCtr1++) {
        Customer myCustomer = (Customer)customerArray.get_Item(iCtr1);
        // Add a child treenode for each Order object.
        int i = 0;
        TreeNode myTreeNodeArray[] = new TreeNode[5];
        for (int iCtr2 = 0; iCtr2 < myCustomer.customerOrders.get_Count();
            iCtr2++) {
            Order myOrder = (Order)myCustomer.customerOrders.get_Item(iCtr2);
            myTreeNodeArray.set_Item(i, new TreeNode(myOrder.orderID));
            i++;
        }
        TreeNode customerNode =
            new TreeNode(myCustomer.customerName, myTreeNodeArray);
        // Display the customer names with and Orange font.
        customerNode.set_ForeColor(Color.get_Orange());
        // Store the Customer object in the Tag property of the TreeNode.
        customerNode.set_Tag(myCustomer);
        myTreeView.get_Nodes().get_Item(0).get_Nodes().Add(customerNode);
    }
} //AddRootNodes

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TreeNode-Klasse
TreeNode-Member
System.Windows.Forms-Namespace
LabelEdit
BeginEdit
TreeNode.IsEditing-Eigenschaft