TreeNode.Tag プロパティ

.NET Framework クラス ライブラリ リファレンス

TreeNode.Tag プロパティ

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(False)> _
<BindableAttribute(True)> _
Public Property Tag As Object

Visual Basic (使用法)

Dim instance As TreeNode
Dim value As Object

value = instance.Tag

instance.Tag = value

C#

[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public Object Tag { get; set;
 }

C++

[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public:
property Object^ Tag {
    Object^ get ();
    void set (Object^ value);
}

J#

/** @property */
public Object get_Tag ()

/** @property */
public void set_Tag (Object value)

JScript

public function get Tag
 () : Object

public function set Tag
 (value : Object)

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

解説

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

使用例

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

Visual Basic

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++

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 );
   }
}

J#

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TreeNode クラス
TreeNode メンバ
System.Windows.Forms 名前空間
Object