TreeView 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
顯示一組階層式標記項目集合，每個項目以 表示。TreeNode
public ref class TreeView : System::Windows::Forms::Controlpublic class TreeView : System.Windows.Forms.Control[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class TreeView : System.Windows.Forms.Control[System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)]
public class TreeView : System.Windows.Forms.Controltype TreeView = class
inherit Control[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type TreeView = class
inherit Control[<System.Windows.Forms.Docking(System.Windows.Forms.DockingBehavior.Ask)>]
type TreeView = class
inherit ControlPublic Class TreeView
Inherits Control- 繼承
- 衍生
- 屬性
範例
以下程式碼範例展示了控制項的使用 TreeView 。
// Populates a TreeView control with example nodes.
private void InitializeTreeView()
{
treeView1.BeginUpdate();
treeView1.Nodes.Add("Parent");
treeView1.Nodes[0].Nodes.Add("Child 1");
treeView1.Nodes[0].Nodes.Add("Child 2");
treeView1.Nodes[0].Nodes[1].Nodes.Add("Grandchild");
treeView1.Nodes[0].Nodes[1].Nodes[0].Nodes.Add("Great Grandchild");
treeView1.EndUpdate();
}
' Populates a TreeView control with example nodes.
Private Sub InitializeTreeView()
treeView1.BeginUpdate()
treeView1.Nodes.Add("Parent")
treeView1.Nodes(0).Nodes.Add("Child 1")
treeView1.Nodes(0).Nodes.Add("Child 2")
treeView1.Nodes(0).Nodes(1).Nodes.Add("Grandchild")
treeView1.Nodes(0).Nodes(1).Nodes(0).Nodes.Add("Great Grandchild")
treeView1.EndUpdate()
End Sub
以下較複雜的程式碼範例在控制中顯示客戶資訊 TreeView 。 根樹節點顯示客戶名稱，子樹節點則顯示分配給每位客戶的訂單號碼。 在此範例中，顯示 1,000 名客戶，每人有 15 筆訂單。 重新上色 TreeView 會被使用 BeginUpdate and EndUpdate 方法抑制，並顯示等待 Cursor 畫面，等待物件 TreeView 的建立與上色 TreeNode 。 這個例子要求你有一個 Customer 物件可以容納一組 Order 物件。 它還需要你在應用程式目錄中有一個命名 MyWait.cur 的游標檔案，並且你在 TreeViewForm.
// 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 分配給控制的 TreeView 物件。 此集合中的樹節點稱為根樹節點。 任何隨後加入根樹節點的樹節點都稱為子節點。 由於每個 TreeNode 物件可能包含其他 TreeNode 物件集合，當你遍歷集合時，可能會發現自己在樹狀結構中的位置會變得困難。 你可以 TreeNode.FullPath 用 PathSeparator 字串值來解析字串，判斷標籤的起點和 TreeNode 結束點。
你可以在樹節點旁邊顯示圖片，方法是將 a ImageList 指派到 ImageList 屬性，並在 中引用 的ImageImageList索引值來指派該 Image。 請使用以下屬性來指派圖片：
將屬性設定 ImageIndex 為你想在未選取樹節點時顯示的索引值 Image 。
將屬性設定 SelectedImageIndex 為你想在選取樹節點時顯示的索引值 Image 。
由 ImageIndex 和 SelectedImageIndex 屬性值所參考的影像，是所有被指派給該 Nodes 集合的樹節點所顯示的預設影像。 個別樹節點可以透過設定 TreeNode.ImageIndex 和 TreeNode.SelectedImageIndex 屬性來覆蓋預設影像。
預設顯示的 TreeView 狀態影像為 16 x 16 像素。 設定 ImageSize 的屬性 StateImageList 不會影響影像的顯示方式。 然而，當 app.config 檔案包含以下項目時，狀態影像會依系統 DPI 設定重新大小：
<appSettings>
<add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>
樹節點可以展開以顯示下一層子樹節點。 使用者可TreeNode點擊加號（+）按鈕展開，若 旁邊顯示TreeNode加號，或呼叫TreeNode.Expand方法來擴充TreeNode。 若要展開集合中 Nodes 所有子樹節點層級，請呼叫該 ExpandAll 方法。 你可以呼叫TreeNode.Collapse該方法來摺疊子TreeNode節點，或使用者若旁邊顯示TreeNode負號（-）按鈕，則按下。 你也可以呼叫該 TreeNode.Toggle 方法，在展開狀態和崩潰狀態間交替切換。
樹節點可選擇性地顯示勾選框。 要顯示勾選框，請將 的TreeView屬性設CheckBoxes為 true。
Checked屬性設定為 ，true適用於處於檢查狀態的樹節點。
備註
從 or AfterCheck 事件中BeforeCheck設定TreeNode.Checked屬性會導致事件被多次觸發，並可能導致意外行為。 例如，當你遞迴更新子節點時，可以在事件處理程序中設定該 Checked 屬性，讓使用者不必逐個展開並檢查。 為了防止事件被多次提出，請在事件處理程序中加入邏輯，只有在 Action 的 TreeViewEventArgs 屬性未設為 TreeViewAction.Unknown時才執行遞迴程式碼。 關於如何做到這點，請參考 or BeforeCheck 事件的AfterCheck範例部分。
你可以透過設定控制項的顯示和樣式屬性來改變其外觀 TreeView 。 設定 ShowPlusMinus 到 true 會在每個 TreeNode 圖塊旁邊顯示一個可展開或摺疊的加號或負號按鈕。 將屬性設 ShowRootLines 為 會 true 顯示 TreeView 連接所有根樹節點的線條。 你可以將子樹節點與根節點連接起來，方法是將屬性設 ShowLines 為 true。 將屬性設 HotTracking 為 時 true ，當滑鼠指標通過樹節點標籤時，會改變它們的外觀。 熱軌追蹤時，樹狀節點標籤呈現超連結的外觀。 你也可以完全自訂控制器的 TreeView 外觀。 要做到這點，請將屬性設 DrawMode 為 非 的 TreeViewDrawMode.Normal 值，並處理 DrawNode 該事件。
備註
當執行時設定 CheckBoxes、 Scrollable、 ImageIndex和 SelectedImageIndex 屬性時， TreeView 會重新建立 handle（參見 Control.RecreateHandle），以更新控制項的外觀。 這會導致所有樹節點都被收斂，除了被選中的 TreeNode節點。
建構函式
| 名稱 | Description |
|---|---|
| TreeView() |
初始化 TreeView 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述，供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定一個值，指示控制器是否能接受使用者拖曳到的資料。 (繼承來源 Control) |
| Anchor |
取得或設定控制項綁定容器的邊緣，並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定，將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
此性質對此類別無關。 (繼承來源 Control) |
| BackColor |
取得或設定控制點的背景色。 |
| BackgroundImage |
取得或設定控制點的 TreeView 背景影像。 |
| BackgroundImageLayout |
取得或設定控制區背景影像 TreeView 的佈局。 |
| BindingContext |
取得或設定 BindingContext 控制。 (繼承來源 Control) |
| BorderStyle |
取得或設定樹狀視圖控制項的邊界樣式。 |
| Bottom |
取得控制項底部邊緣與容器用戶端區域頂部邊緣之間的距離（像素）。 (繼承來源 Control) |
| Bounds |
取得或設定控制項的大小與位置，包括非用戶端元素，以像素為單位，相對於父控制項。 (繼承來源 Control) |
| CanEnableIme |
會取得一個值，表示該屬性是否 ImeMode 能被設定為主動值，以支援 IME。 (繼承來源 Control) |
| CanFocus |
會獲得一個值，表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值，表示是否可以選擇該控制項。 (繼承來源 Control) |
| Capture |
取得或設定一個值，表示控制器是否已捕捉該滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定一個值，指示該控制是否導致在收到焦點時對需要驗證的控制項進行驗證。 (繼承來源 Control) |
| CheckBoxes |
取得或設定一個值，指示樹狀檢視控制中是否顯示在樹節點旁的勾選框。 |
| ClientRectangle |
取得代表控制區客戶端區域的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制區客戶區域的高度與寬度。 (繼承來源 Control) |
| CompanyName |
取得包含控制權的公司名稱或應用程式的創建者名稱。 (繼承來源 Control) |
| Container |
得到 IContainer 包含 Component的 。 (繼承來源 Component) |
| ContainsFocus |
會獲得一個值，表示該控制項或其子控制項目前是否擁有輸入焦點。 (繼承來源 Control) |
| ContextMenu |
已淘汰.
取得或設定與控制鍵相關的捷徑選單。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定 ContextMenuStrip 與此控制相關聯的 (繼承來源 Control) |
| Controls |
取得控制中包含的控制項集合。 (繼承來源 Control) |
| Created |
會得到一個值，表示控制是否已被建立。 (繼承來源 Control) |
| CreateParams |
當控制句柄建立時，會取得所需的建立參數。 |
| Cursor |
當滑鼠指標位於控制器上時，會顯示或設定游標。 (繼承來源 Control) |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制鍵的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
可獲得控制項所支援的預設輸入法編輯器（IME）模式。 (繼承來源 Control) |
| DefaultMargin |
取得預設控制點間設定的像素空間。 (繼承來源 Control) |
| DefaultMaximumSize |
取得控制項預設最大大小的長度與高度（像素數）。 (繼承來源 Control) |
| DefaultMinimumSize |
取得控制項預設最小大小的長度與高度（像素）。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距（像素）。 (繼承來源 Control) |
| DefaultSize |
會得到預設大小的控制器。 |
| DesignMode |
會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項所在顯示器的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得代表控制器顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
會取得一個值，表示基底 Control 類別是否正在處理中。 (繼承來源 Control) |
| Dock |
取得或設定哪些控制邊界對接到其父控制，並決定控制點如何與父控制進行調整大小。 (繼承來源 Control) |
| DoubleBuffered |
取得或設定一個值，指示控制項是否應該使用次級緩衝區重新繪製表面。 DoubleBuffered該性質不影響控制。TreeView |
| DrawMode |
取得或設定控制的模式。 |
| Enabled |
取得或設定一個值，表示控制項是否能回應使用者互動。 (繼承來源 Control) |
| Events |
會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component) |
| Focused |
會得到一個值，表示控制器是否有輸入焦點。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示文字的字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制鍵字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制鍵的前景色。 |
| FullRowSelect |
取得或設定一個值，表示選取高亮是否跨越樹狀檢視控制的寬度。 |
| Handle |
它會得到控制項綁定的視窗把手。 (繼承來源 Control) |
| HasChildren |
會取得一個值，表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| HideSelection |
會取得或設定一個值，指示即使樹狀檢視失去焦點，所選樹節點是否仍保持高亮。 |
| HotTracking |
會取得或設定一個值，指示樹節點標籤在滑鼠指標經過時是否呈現超連結的外觀。 |
| ImageIndex |
取得或設定樹節點顯示的預設影像的影像清單索引值。 |
| ImageKey |
當控制節點處於未選取狀態時，取得或設定預設影像 TreeView 的鍵。 |
| ImageList | |
| ImeMode |
取得或設定控制器的輸入法編輯器（IME）模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制的 IME 模式。 (繼承來源 Control) |
| Indent |
取得或設定距離以縮排每個子樹節點層級。 |
| InvokeRequired |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 Control) |
| IsMirrored |
會得到一個值，表示該控制是否為鏡像。 (繼承來源 Control) |
| ItemHeight |
取得或設定樹狀檢視控制中每個樹節點的高度。 |
| LabelEdit |
取得或設定一個值，表示樹節點的標籤文字是否可編輯。 |
| LayoutEngine |
會取得控制點的佈局引擎的快取實例。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊與容器客戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| LineColor |
取得或設定連接控制節點 TreeView 線條的顏色。 |
| Location |
取得或設定控制器左上角相對於容器左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制區之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定的上限是可以指定的上限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MinimumSize |
取得或設定的尺寸是可指定的下限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| Name |
取得或設定控制的名稱。 (繼承來源 Control) |
| Nodes |
取得分配給樹狀檢視控制項的樹節點集合。 |
| Padding |
取得或設定控制器內容與邊緣之間的 TreeView 間距。 |
| Parent |
取得或設定控制的父容器。 (繼承來源 Control) |
| PathSeparator |
取得或設定樹節點路徑所使用的分隔符字串。 |
| PreferredSize |
大小相當於一個長方形區域，控制器可以放進去。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組裝版本。 (繼承來源 Control) |
| RecreatingHandle |
會取得一個值，表示該控制項目前是否正在重新建立其句柄。 (繼承來源 Control) |
| Region |
取得或設定與控制項相關的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
該物業現已過時。 (繼承來源 Control) |
| ResizeRedraw |
會取得或設定一個值，表示控制項在調整時是否會自行重新繪製。 (繼承來源 Control) |
| Right |
取得控制器右邊與容器用戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| RightToLeft |
取得或設定一個值，指示 control 元素是否對齊以支援使用右至左字型的區域。 (繼承來源 Control) |
| RightToLeftLayout |
取得或設定一個值，指示是否 TreeView 應該從右到左排列。 |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| Scrollable |
取得或設定一個值，指示樹狀檢視控制項是否在需要時顯示捲動條。 |
| SelectedImageIndex |
取得或設定選取樹節點時顯示的影像清單索引值。 |
| SelectedImageKey |
取得或設定當 a TreeNode 處於選擇狀態時所顯示的預設影像的鍵。 |
| SelectedNode |
取得或設定目前在樹狀檢視控制中選取的樹節點。 |
| ShowFocusCues |
會得到一個值，指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值，表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| ShowLines |
取得或設定一個值，指示樹狀節點間是否在樹狀檢視控制中畫線。 |
| ShowNodeToolTips |
當滑鼠指標懸停在 TreeNode上時，會顯示或設定一個值，表示工具提示會顯示。 |
| ShowPlusMinus |
取得或設定一個值，指示是否顯示加號（+）和負號（-）按鈕，並顯示在包含子樹節點的樹狀節點旁。 |
| ShowRootLines |
取得或設定一個值，表示樹狀節點間是否會畫線，這些節點位於樹視圖的根節點。 |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| Sorted |
取得或設定一個值，表示樹狀視圖中的樹節點是否被排序。 |
| StateImageList |
取得或設定用來表示 及其 TreeView 節點狀態的影像清單。 |
| TabIndex |
取得或設定容器內控制項的制表順序。 (繼承來源 Control) |
| TabStop |
取得或設定一個值，指示使用者是否能使用 TAB 鍵將焦點分配給此控制項。 (繼承來源 Control) |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
取得或設定 的 TreeView文字。 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離（以像素為單位）。 (繼承來源 Control) |
| TopLevelControl |
取得沒有被其他 Windows Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| TopNode |
取得或設定樹狀圖控制中第一個完全可見的樹節點。 |
| TreeViewNodeSorter | |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| VisibleCount |
取得樹狀檢視控制中可完全顯示的樹節點數量。 |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| AfterCheck |
發生在勾選樹節點勾選框之後。 |
| AfterCollapse |
發生在樹節點崩潰後。 |
| AfterExpand |
發生在樹節點展開後。 |
| AfterLabelEdit |
發生在編輯樹節點標籤文字之後。 |
| AfterSelect |
發生在選擇樹節點之後。 |
| AutoSizeChanged |
這個活動與本班無關。 (繼承來源 Control) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
當房產變更時 BackgroundImage 發生。 |
| BackgroundImageLayoutChanged |
當房產變更時 BackgroundImageLayout 發生。 |
| BeforeCheck |
發生在樹節點勾選框之前。 |
| BeforeCollapse |
發生在樹節點崩潰之前。 |
| BeforeExpand |
發生在樹節點展開之前。 |
| BeforeLabelEdit |
發生在編輯樹節點標籤文字之前。 |
| BeforeSelect |
發生在選擇樹節點之前。 |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
當焦點或鍵盤使用者介面（UI）提示改變時，會發生這種情況。 (繼承來源 Control) |
| Click |
當按下控制器時會發生。 (繼承來源 Control) |
| ClientSizeChanged |
發生於 ClientSize 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuChanged |
已淘汰.
發生於 ContextMenu 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuStripChanged |
發生於 ContextMenuStrip 屬性的值變更時。 (繼承來源 Control) |
| ControlAdded |
當新增控制項加入 Control.ControlCollection時，會發生。 (繼承來源 Control) |
| ControlRemoved |
當控制項從 中移除 Control.ControlCollection時發生。 (繼承來源 Control) |
| CursorChanged |
發生於 Cursor 屬性的值變更時。 (繼承來源 Control) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 Control) |
| Disposed |
當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component) |
| DockChanged |
發生於 Dock 屬性的值變更時。 (繼承來源 Control) |
| DoubleClick |
當雙擊按鈕時會發生。 (繼承來源 Control) |
| DpiChangedAfterParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 改變後，程式方式更改時會發生。 (繼承來源 Control) |
| DpiChangedBeforeParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 變更事件尚未發生之前，程式化地更改時就會發生。 (繼承來源 Control) |
| DragDrop |
當拖放操作完成時會發生。 (繼承來源 Control) |
| DragEnter |
當物體被拖入控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragLeave |
當物體被拖出控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragOver |
當物體被拖過控制範圍時會發生。 (繼承來源 Control) |
| DrawNode |
當抽取 a TreeView 且 DrawMode 屬性設定 TreeViewDrawMode 為非 Normal的值時，會發生。 |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
當進入控制區時發生。 (繼承來源 Control) |
| FontChanged |
當房產價值變動時 Font 發生。 (繼承來源 Control) |
| ForeColorChanged |
當房產價值變動時 ForeColor 發生。 (繼承來源 Control) |
| GiveFeedback |
發生在拖曳操作期間。 (繼承來源 Control) |
| GotFocus |
當控制裝置被聚焦時發生。 (繼承來源 Control) |
| HandleCreated |
當控制器被建立把柄時，會發生這種情況。 (繼承來源 Control) |
| HandleDestroyed |
當控制器的把手正在被摧毀時，會發生這種情況。 (繼承來源 Control) |
| HelpRequested |
當使用者請求控制權協助時會發生。 (繼承來源 Control) |
| ImeModeChanged |
當房產發生變化時 ImeMode 。 (繼承來源 Control) |
| Invalidated |
當控制器顯示需要重新繪製時，會發生這種情況。 (繼承來源 Control) |
| ItemDrag |
當使用者開始拖曳節點時，會發生這種情況。 |
| KeyDown |
當按鍵時，控制器處於焦點狀態時會發生。 (繼承來源 Control) |
| KeyPress |
當按鍵在控制鍵處於焦點狀態時，按下字元、空白鍵或退格鍵時會發生。 (繼承來源 Control) |
| KeyUp |
當控制鍵處於對焦狀態時放開鍵時會發生。 (繼承來源 Control) |
| Layout |
當控制項應該重新定位其子控制項時，會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開控制器時會發生。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當滑鼠點擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDoubleClick |
當滑鼠雙擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDown |
當滑鼠指標放在控制器上，按下滑鼠按鈕時會發生。 (繼承來源 Control) |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 (繼承來源 Control) |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 (繼承來源 Control) |
| MouseMove |
當滑鼠指標移到控制器上時會發生。 (繼承來源 Control) |
| MouseUp |
當滑鼠指標放在控制器上方並放開滑鼠按鈕時，會發生這種情況。 (繼承來源 Control) |
| MouseWheel |
當滑鼠滾輪移動時，控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| NodeMouseClick |
當使用者用滑鼠點擊 a TreeNode 時會發生。 |
| NodeMouseDoubleClick |
當使用者用滑鼠雙擊 a TreeNode 鍵時會發生。 |
| NodeMouseHover |
當滑鼠懸停在 TreeNode. |
| PaddingChanged |
發生於 Padding 屬性的值變更時。 |
| Paint |
當 被 TreeView 抽取時發生。 |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時，會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時，會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間，使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
當房產價值變動時 RightToLeft 發生。 (繼承來源 Control) |
| RightToLeftLayoutChanged |
發生於 RightToLeftLayout 屬性的值變更時。 |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
當房產價值變動時 TabIndex 發生。 (繼承來源 Control) |
| TabStopChanged |
當房產價值變動時 TabStop 發生。 (繼承來源 Control) |
| TextChanged |
當房產變更時 Text 發生。 |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
