TreeNode.Tag プロパティ

ツリー ノードに関するデータを格納するオブジェクトを取得または設定します。

Public Property Tag As Object
[C#]
public object Tag {get; set;}
[C++]
public: __property Object* get_Tag();public: __property void set_Tag(Object*);
[JScript]
public function get Tag() : Object;public function set Tag(Object);

プロパティ値

ツリー ノードに関するデータを格納している Object 。既定値は null 参照 (Visual Basic では Nothing) です。

解説

任意の Object 派生型をこのプロパティに割り当てることができます。このプロパティが Windows フォーム デザイナによって設定されている場合は、テキストだけを割り当てることができます。

使用例

[Visual Basic, C#, C++] 子ツリー ノードの割り当て先とするルート ツリー ノードを作成する例を次に示します。 ArrayList の各 Customer オブジェクトの子ツリー ノードは、ルート ツリー ノードと、 Customer オブジェクトに割り当てられている各 Order オブジェクトの子ツリー ノードに追加されます。 Customer オブジェクトは Tag プロパティに割り当てられ、 Customer オブジェクトを表すツリー ノードは Orange テキストで表示されます。この例は、 Customer オブジェクトと Order オブジェクトが定義されていて、 TreeView コントロールが Form に配置されていて、 Customer オブジェクトを含む customerArray という名前の ArrayList があることを前提にしています。

 
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

[C#] 
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);
   }
}

[C++] 
public:
    void AddRootNodes() {
        // Add a root node to assign the customer nodes to.
        TreeNode* rootNode = new TreeNode();
        rootNode->Text = S"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 = __try_cast<Customer*>(myEnum->Current);

            // Add a child treenode for each Order object.
            int i = 0;
            TreeNode* myTreeNodeArray[] = new TreeNode*[5];
            IEnumerator* myEnum = myCustomer->CustomerOrders->GetEnumerator();
            while (myEnum->MoveNext()) {
                Order* myOrder = __try_cast<Order*>(myEnum->Current);
                myTreeNodeArray->Item[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->Item[0]->Nodes->Add(customerNode);
        }
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

TreeNode クラス | TreeNode メンバ | System.Windows.Forms 名前空間 | Object