TreeNode クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

継承: Object

MarshalByRefObject
TreeNode

派生: System.ComponentModel.Design.ObjectSelectorEditor.SelectorNode

System.Workflow.ComponentModel.Design.WorkflowOutlineNode

属性: TypeConverterAttribute SerializableAttribute

実装: ICloneable ISerializable

例

次のコード例では、コントロールに顧客情報を TreeView 表示します。ルートツリーノードには顧客名が表示され、子ツリーノードには各顧客に割り当てられた注文番号が表示されます。この例では、1,000 人の顧客がそれぞれ 15 件の注文と共に表示されます。メソッドと EndUpdate メソッドを使用BeginUpdateすると、 TreeView の再描画が抑制され、がオブジェクトを作成して描画している間にTreeView待機CursorがTreeNode表示されます。この例では、オブジェクトのOrderコレクションをCustomer保持できるオブジェクトが必要です。また、でコントロールFormのインスタンスをTreeView作成している必要もあります。

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

注釈

コレクションにはNodes、現在TreeNodeのに割り当てられているすべての子TreeNodeオブジェクトが保持されます。を追加、削除、または複製 TreeNodeできます。これを行うと、すべての子ツリーノードが追加、削除、または複製されます。各 TreeNode オブジェクトには、他 TreeNode のオブジェクトのコレクションを含めることができます。これにより、コレクションを反復処理するときに、 TreeView 内のどこにいるかを判断するのが困難になる可能性があります。ツリー構造内の位置を確認するには、プロパティを FullPath 使用します。文字列は FullPath 、文字列値を PathSeparator 使用して解析して、ラベルの開始位置と終了位置を TreeNode 決定できます。

ラベルは TreeNode 、プロパティを明示的に Text 設定することによって設定されます。別の方法として、プロパティを表す文字列パラメーターを TreeNode 持つコンストラクターのいずれかを使用してツリーノードを Text 作成します。ラベルが表示されている場合は、画像の TreeNode 横にラベルが表示されます。

ツリーノードの横に画像を表示するには、親TreeViewコントロールのプロパティにをImageList割り当てImageList、プロパティのインデックス値をImage参照してをImageList割り当てます。がImageIndex選択されていない状態のときに表示TreeNodeするのImageインデックス値にプロパティを設定します。同様に、プロパティを SelectedImageIndex 、が選択されたときに表示するの Image インデックス値に TreeNode 設定します。

特定のツリーノードを選択し、コレクションをNodes反復処理するには、、、LastNode PrevNode NextNode、NextVisibleNode、 PrevVisibleNodeの各プロパティ値FirstNodeを使用します。 TreeNode前述のプロパティの 1 つによって返されたをプロパティにTreeView.SelectedNode割り当てて、コントロール内のツリーノードをTreeView選択します。

ツリーノードを展開して、次のレベルの子ツリーノードを表示できます。ユーザーは、のTreeNode横にあるプラス (+) ボタンを押してを展開するか、メソッドをTreeNode呼び出ExpandしてをTreeNode展開できます。コレクション内のすべての子ツリーノードレベルを Nodes 展開するには、メソッドを ExpandAll 呼び出します。メソッドを呼び出して子 TreeNode レベルを Collapse 折りたたむか、の横にある TreeNodeマイナス (-) ボタンを押すことができます (表示されている場合)。メソッドを Toggle 呼び出して、展開された状態と折りたたまれた状態の間でを交互 TreeNode に呼び出すこともできます。

ツリーノードでは、必要に応じてチェックボックスを表示できます。チェックボックスを表示するには、の TreeView プロパティを CheckBoxes にtrue設定します。プロパティは Checked 、チェック状態のツリーノードに対してに true 設定されます。

コンストラクター

TreeNode()	TreeNode クラスの新しいインスタンスを初期化します。
TreeNode(SerializationInfo, StreamingContext)	シリアル化情報とコンテキストを指定して、TreeNode クラスの新しいインスタンスを初期化します。
TreeNode(String)	ラベルテキストを指定して、TreeNode クラスの新しいインスタンスを初期化します。
TreeNode(String, Int32, Int32)	ラベルテキストと、ツリーノードが選択されているときと選択されていないときに表示するイメージをそれぞれ指定して、TreeNode クラスの新しいインスタンスを初期化します。
TreeNode(String, Int32, Int32, TreeNode[])	ラベルテキスト、子ツリーノード、およびツリーノードが選択されているときと選択されていないときに表示するイメージをそれぞれ指定して、TreeNode クラスの新しいインスタンスを初期化します。
TreeNode(String, TreeNode[])	指定したラベルテキストと子ツリーノードを使用して、TreeNode クラスの新しいインスタンスを初期化します。

プロパティ

BackColor	ツリーノードの背景色を取得または設定します。
Bounds	ツリーノードの範囲を取得します。
Checked	ツリーノードがチェックされているかどうかを示す値を取得または設定します。
ContextMenu	このツリーノードに関連付けられているショートカットメニューを取得します。
ContextMenuStrip	このツリーノードに関連付けられているショートカットメニューを取得または設定します。
FirstNode	ツリーノードコレクション内の最初の子ツリーノードを取得します。
ForeColor	ツリーノードの前景色を取得または設定します。
FullPath	ルートツリーノードから現在のツリーノードまでのパスを取得します。
Handle	ツリーノードのハンドルを取得します。
ImageIndex	ツリーノードが選択されていないときに表示されるイメージのイメージリスト内のインデックス値を取得または設定します。
ImageKey	このツリーノードが選択されていないときに、ノードに関連付けられるイメージのキーを取得または設定します。
Index	ツリーノードコレクション内のツリーノードの位置を取得します。
IsEditing	ツリーノードを編集できるかどうかを示す値を取得します。
IsExpanded	ツリーノードが展開されているかどうかを示す値を取得します。
IsSelected	ツリーノードが選択されているかどうかを示す値を取得します。
IsVisible	ツリーノードが表示されている、または部分的に表示されているかどうかを示す値を取得します。
LastNode	最後の子ツリーノードを取得します。
Level	TreeView コントロールにおけるツリーノードの深さを取得します。最初の深さは 0 です。
Name	ツリーノードの名前を取得または設定します。
NextNode	次のレベルにある兄弟ツリーノードを取得します。
NextVisibleNode	次のレベルにある、表示されているツリーノードを取得します。
NodeFont	ツリーノードラベルのテキストを表示するために使用するフォントを取得または設定します。
Nodes	現在のツリーノードに割り当てられている TreeNode オブジェクトのコレクションを取得します。
Parent	現在のツリーノードの親ツリーノードを取得します。
PrevNode	前のレベルにある兄弟ツリーノードを取得します。
PrevVisibleNode	前のレベルにある、表示されているツリーノードを取得します。
SelectedImageIndex	ツリーノードが選択されているときに表示されるイメージのイメージリスト内のインデックス値を取得または設定します。
SelectedImageKey	ツリーノードが選択されている状態のときに表示されるイメージのキーを取得または設定します。
StateImageIndex	親 TreeNode の TreeView プロパティが `false` に設定されている場合に、CheckBoxes の状態を示すために使用されるイメージのインデックスを取得または設定します。
StateImageKey	親 TreeNode の TreeView プロパティが `false` に設定されている場合に、CheckBoxes の状態を示すために使用されるイメージのキーを取得または設定します。
Tag	ツリーノードに関するデータを格納するオブジェクトを取得または設定します。
Text	ツリーノードのラベルに表示されるテキストを取得または設定します。
ToolTipText	マウスポインターを TreeNode に重ねたときに表示されるテキストを取得または設定します。
TreeView	ツリーノードが割り当てられている親ツリービューを取得します。

メソッド

BeginEdit()	ツリーノードのラベルの編集を開始します。
Clone()	ツリーノードと、そのツリーノードをルートとするサブツリー全体をコピーします。
Collapse()	ツリーノードを折りたたみます。
Collapse(Boolean)	TreeNode を折りたたみます。オプションで、子ノードも折りたたみます。
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Deserialize(SerializationInfo, StreamingContext)	指定された TreeNode から SerializationInfo の状態を読み込みます。
EndEdit(Boolean)	ツリーノードラベルの編集を終了します。
EnsureVisible()	ツリーノードが確実に表示されるようにします。必要に応じてツリーノードを展開し、ツリービューコントロールをスクロールします。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Expand()	ツリーノードを展開します。
ExpandAll()	すべての子ツリーノードを展開します。
FromHandle(TreeView, IntPtr)	指定されたハンドルを持ち、指定されたツリービューコントロールに割り当てられているツリーノードを返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetNodeCount(Boolean)	子ツリーノードの数を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
Remove()	ツリービューコントロールから現在のツリーノードを削除します。
Serialize(SerializationInfo, StreamingContext)	指定された TreeNode に、SerializationInfo の状態を保存します。
Toggle()	ツリーノードの展開された状態と折りたたまれた状態を切り替えます。
ToString()	現在のオブジェクトを表す文字列を返します。

明示的なインターフェイスの実装

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

シリアル化情報オブジェクトを、TreeNode のシリアル化に必要なデータで事前設定します。

適用対象