TreeNodeCollection.Add 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将新树节点添加到集合。
重载
| 名称 | 说明 |
|---|---|
| Add(String) |
将具有指定标签文本的新树节点添加到当前树节点集合的末尾。 |
| Add(TreeNode) |
将以前创建的树节点添加到树节点集合的末尾。 |
| Add(String, String) |
创建具有指定键和文本的新树节点,并将其添加到集合中。 |
| Add(String, String, Int32) |
创建具有指定键、文本和图像的树节点,并将其添加到集合中。 |
| Add(String, String, String) |
创建具有指定键、文本和图像的树节点,并将其添加到集合中。 |
| Add(String, String, Int32, Int32) |
创建具有指定键、文本和图像的树节点,并将其添加到集合中。 |
| Add(String, String, String, String) |
创建具有指定键、文本和图像的树节点,并将其添加到集合中。 |
Add(String)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
将具有指定标签文本的新树节点添加到当前树节点集合的末尾。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ text);
public virtual System.Windows.Forms.TreeNode Add(string text);
public virtual System.Windows.Forms.TreeNode Add(string? text);
abstract member Add : string -> System.Windows.Forms.TreeNode
override this.Add : string -> System.Windows.Forms.TreeNode
Public Overridable Function Add (text As String) As TreeNode
参数
返回
一个 TreeNode 表示要添加到集合中的树节点。
示例
下面的代码示例在控件中 TreeView 显示客户信息。 根树节点显示客户名称,子树节点显示分配给每个客户的订单编号。 在此示例中,将显示 1,000 个客户,每个订单 15 个。 通过使用和方法取消重新绘制TreeView,创建和绘制TreeNode对象时TreeView会显示等待Cursor。EndUpdateBeginUpdate 此示例要求你有一个 Customer 可以保存对象集合 Order 的对象。 它还要求你已在某个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
注解
还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
若要删除之前添加的、TreeNode使用RemoveRemoveAt或Clear方法。
另请参阅
适用于
Add(TreeNode)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
将以前创建的树节点添加到树节点集合的末尾。
public:
virtual int Add(System::Windows::Forms::TreeNode ^ node);
public virtual int Add(System.Windows.Forms.TreeNode node);
abstract member Add : System.Windows.Forms.TreeNode -> int
override this.Add : System.Windows.Forms.TreeNode -> int
Public Overridable Function Add (node As TreeNode) As Integer
参数
返回
添加到树节点集合的从零开始的 TreeNode 索引值。
例外
当前 node 分配给另一个 TreeView。
示例
下面的代码示例在控件中 TreeView 显示客户信息。 根树节点显示客户名称,子树节点显示分配给每个客户的订单编号。 在此示例中,将显示 1,000 个客户,每个订单 15 个。 通过使用和方法取消重新绘制TreeView,创建和绘制TreeNode对象时TreeView会显示等待Cursor。EndUpdateBeginUpdate 此示例要求你有一个 Customer 可以保存对象集合 Order 的对象。 它还要求你已在某个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
注解
此版本的 Add 方法允许将以前创建 TreeNode 的对象添加到树节点集合的末尾。
还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
若要删除之前添加的、TreeNode使用RemoveRemoveAt或Clear方法。
另请参阅
适用于
Add(String, String)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
创建具有指定键和文本的新树节点,并将其添加到集合中。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ key, System::String ^ text);
public virtual System.Windows.Forms.TreeNode Add(string key, string text);
public virtual System.Windows.Forms.TreeNode Add(string? key, string? text);
abstract member Add : string * string -> System.Windows.Forms.TreeNode
override this.Add : string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Add (key As String, text As String) As TreeNode
参数
- key
- String
树节点的名称。
- text
- String
要显示在树节点中的文本。
返回
已 TreeNode 添加到集合中的项。
注解
该 Name 属性对应于中某个 TreeNode 项的 TreeNodeCollection键。
还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
适用于
Add(String, String, Int32)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
创建具有指定键、文本和图像的树节点,并将其添加到集合中。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ key, System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.TreeNode Add(string key, string text, int imageIndex);
public virtual System.Windows.Forms.TreeNode Add(string? key, string? text, int imageIndex);
abstract member Add : string * string * int -> System.Windows.Forms.TreeNode
override this.Add : string * string * int -> System.Windows.Forms.TreeNode
Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As TreeNode
参数
- key
- String
树节点的名称。
- text
- String
要显示在树节点中的文本。
- imageIndex
- Int32
要显示在树节点中的图像的索引。
返回
已 TreeNode 添加到集合中的项。
注解
该 Name 属性对应于中某个 TreeNode 项的 TreeNodeCollection键。
该imageIndex参数引用父TreeView级属性中的ImageList图像。
树节点将添加到集合的末尾。 还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
适用于
Add(String, String, String)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
创建具有指定键、文本和图像的树节点,并将其添加到集合中。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.TreeNode Add(string key, string text, string imageKey);
public virtual System.Windows.Forms.TreeNode Add(string? key, string? text, string? imageKey);
abstract member Add : string * string * string -> System.Windows.Forms.TreeNode
override this.Add : string * string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Add (key As String, text As String, imageKey As String) As TreeNode
参数
- key
- String
树节点的名称。
- text
- String
要显示在树节点中的文本。
- imageKey
- String
要显示在树节点中的图像。
返回
已 TreeNode 添加到集合中的项。
注解
该 Name 属性对应于中某个 TreeNode 项的 TreeNodeCollection键。
树节点将添加到集合的末尾。 还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
该imageKey参数引用父TreeView级属性中的ImageList图像。
适用于
Add(String, String, Int32, Int32)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
创建具有指定键、文本和图像的树节点,并将其添加到集合中。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ key, System::String ^ text, int imageIndex, int selectedImageIndex);
public virtual System.Windows.Forms.TreeNode Add(string key, string text, int imageIndex, int selectedImageIndex);
public virtual System.Windows.Forms.TreeNode Add(string? key, string? text, int imageIndex, int selectedImageIndex);
abstract member Add : string * string * int * int -> System.Windows.Forms.TreeNode
override this.Add : string * string * int * int -> System.Windows.Forms.TreeNode
Public Overridable Function Add (key As String, text As String, imageIndex As Integer, selectedImageIndex As Integer) As TreeNode
参数
- key
- String
树节点的名称。
- text
- String
要显示在树节点中的文本。
- imageIndex
- Int32
要显示在树节点中的图像的索引。
- selectedImageIndex
- Int32
处于选定状态时要显示在树节点中的图像的索引。
返回
已添加到集合中的树节点。
注解
该 Name 属性对应于中某个 TreeNode 项的 TreeNodeCollection键。
树节点将添加到集合的末尾。 还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
该imageIndex参数引用父TreeView级属性中的ImageList图像。
该selectedImageIndex参数引用父TreeView级属性中的StateImageList图像。
适用于
Add(String, String, String, String)
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
- Source:
- TreeNodeCollection.cs
创建具有指定键、文本和图像的树节点,并将其添加到集合中。
public:
virtual System::Windows::Forms::TreeNode ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey, System::String ^ selectedImageKey);
public virtual System.Windows.Forms.TreeNode Add(string key, string text, string imageKey, string selectedImageKey);
public virtual System.Windows.Forms.TreeNode Add(string? key, string? text, string? imageKey, string? selectedImageKey);
abstract member Add : string * string * string * string -> System.Windows.Forms.TreeNode
override this.Add : string * string * string * string -> System.Windows.Forms.TreeNode
Public Overridable Function Add (key As String, text As String, imageKey As String, selectedImageKey As String) As TreeNode
参数
- key
- String
树节点的名称。
- text
- String
要显示在树节点中的文本。
- imageKey
- String
要显示在树节点中的图像的键。
- selectedImageKey
- String
当节点处于选定状态时要显示的图像的键。
返回
已 TreeNode 添加到集合中的项。
注解
该 Name 属性对应于中某个 TreeNode 项的 TreeNodeCollection键。
树节点将添加到集合的末尾。 还可以使用AddRange或Insert方法向集合添加新TreeNode对象。
该imageKey参数引用父TreeView级属性中的ImageList图像。
该selectedImageKey参数引用父TreeView级属性中的StateImageList图像。