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 和 EndUpdate 方法隱藏，而且會在建立和繪製TreeNode物件時TreeView顯示等候Cursor。 此範例會要求您擁有 Customer 可保存 物件集合的 Order 物件。 它也需要您有在應用程式目錄中命名MyWait.cur的數據指標檔案，而且您已在 上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會保存指派給 TreeView 控件的所有TreeNode物件。 此集合中的樹狀節點稱為根樹狀節點。 後續加入根樹狀節點的任何樹狀節點稱為子節點。 因為每個 TreeNode 都可以包含其他 TreeNode 物件的集合，所以當您逐一查看集合時，可能會發現很難判斷樹狀結構中的位置。 您可以使用字串值來剖析 TreeNode.FullPath 字串 PathSeparator ，以判斷標籤的開始和結束位置 TreeNode 。
您可以將 指派ImageList給 ImageList 屬性，並參考 中 ImageList 的索引值，以指派該 Image，以顯示樹狀節點旁的Image影像。 使用下列屬性來指派影像：
將 ImageIndex 屬性設定為在未選取樹狀節點時要顯示的 索引值 Image 。
將 SelectedImageIndex 屬性設定為選取樹狀節點時要顯示的 索引值 Image 。
和 SelectedImageIndex 屬性值所ImageIndex參考的影像是指派給Nodes集合的所有樹狀節點所顯示的預設影像。 個別樹狀節點可以藉由設定 TreeNode.ImageIndex 和 TreeNode.SelectedImageIndex 屬性來覆寫預設影像。
中 TreeView 顯示的狀態影像預設為16 x16像素。 設定 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 方法，在展開和折疊的狀態之間替代。
樹狀節點可以選擇性地顯示複選框。 若要顯示複選框，請將 CheckBoxes 的 TreeView 屬性設定為 true。 屬性 Checked 會針對處於已核取狀態的樹狀節點設定 true 為 。
注意
TreeNode.Checked從 或 AfterCheck 事件中BeforeCheck設定 屬性會導致事件多次引發，而且可能會導致非預期的行為。 例如，當您遞迴更新子節點時，可能會在事件處理程式中設定 Checked 屬性，讓使用者不需要個別展開和檢查每個節點。 若要防止多次引發事件，請將邏輯新增至事件處理程式，只有在 的 TreeViewEventArgs 屬性未設定TreeViewAction.Unknown為 時Action，才會執行遞歸程序代碼。 如需如何執行這項操作的範例，請參閱 或 BeforeCheck 事件的一節AfterCheck。
您可以藉由設定控制件的某些 TreeView 顯示和樣式屬性來變更控制件的外觀。 設定 ShowPlusMinus 以顯示 true 每個可以分別展開或折疊的加號或減號按鈕 TreeNode 。
ShowRootLines將屬性設定為 true 會導致 TreeView 顯示將所有根樹狀節點聯結在一起的行。 您可以將 屬性設定為 true，以顯示將子樹狀節點連接到其根節點的ShowLines行。
HotTracking將屬性設定為true變更樹狀節點標籤的外觀，因為滑鼠指標會經過它們。 當熱追蹤時，樹狀節點標籤會採用超連結的外觀。 您也可以完全自定義控件的外觀 TreeView 。 若要這樣做，請將 DrawMode 屬性設定為 以外的 TreeViewDrawMode.Normal 值，並處理 DrawNode 事件。
注意
在執行時間設定、、 和 SelectedImageIndex 屬性時，TreeView會重新建立句柄 (請參閱 Control.RecreateHandle) 來更新控件ImageIndex的外觀。 ScrollableCheckBoxes 這會導致所有樹狀節點折疊，但選取 TreeNode的 除外。
建構函式
| TreeView() |
初始化 TreeView 類別的新執行個體。 |
屬性
| 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 控制項之背景影像的配置。 |
| BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 Control) |
| BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 Control) |
| BorderStyle |
取得或設定樹狀檢閱控制項的框線樣式。 |
| Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 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 控制項。 |
| DoubleBuffered |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
| DrawMode |
取得或設定要繪製控制項的模式。 |
| Enabled |
取得或設定值，指出控制項是否可回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示之文字字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制項的前景色彩。 |
| FullRowSelect |
取得或設定值，指出反白顯示的選取範圍是否跨過樹狀檢閱控制項寬度。 |
| Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
| HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
| Height |
取得或設定控制項的高度。 (繼承來源 Control) |
| HideSelection |
取得或設定值，指出即使樹狀檢閱已遺失焦點 (Focus)，選取的樹狀節點是否維持反白顯示。 |
| HotTracking |
取得或設定值，指出當滑鼠指標經過樹狀節點標籤時，該標籤是否採用超連結的外觀。 |
| ImageIndex |
取得或設定樹狀節點顯示之預設影像的影像清單索引值。 |
| ImageKey |
針對 TreeView 控制項中每一個位於未選取狀態下的節點取得或設定其預設影像的索引鍵。 |
| ImageList | |
| ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
| Indent |
取得或設定每個子樹狀節點層級的縮排距離。 |
| InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒，因此在進行控制項的方法呼叫時，應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
| IsAccessible |
取得或設定值，指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
指出此控件的其中一個上階是否已月臺，且該月臺位於 DesignMode 中。 這是唯讀的屬性。 (繼承來源 Control) |
| IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
| IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
| IsMirrored |
取得值，指出是否左右反轉控制項。 (繼承來源 Control) |
| ItemHeight |
取得或設定樹狀檢閱控制項的每個樹狀節點高度。 |
| LabelEdit |
取得或設定值，指出是否可編輯樹狀節點的標籤文字。 |
| LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| LineColor |
取得或設定連接 TreeView 控制項的節點之線條色彩。 |
| Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
| MinimumSize |
取得或設定 GetPreferredSize(Size) 可以指定的下限大小。 (繼承來源 Control) |
| Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
| Nodes |
取得指派給樹狀檢閱控制項的樹狀節點集合。 |
| Padding |
取得或設定 TreeView 控制項內容與其邊緣之間的間距。 |
| Padding |
取得或設定控制項內的邊框間距。 (繼承來源 Control) |
| Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
| PathSeparator |
取得或設定樹狀節點路徑使用的分隔符號字串。 |
| PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
| RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
| Region |
取得或設定與控制項關聯的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
| ResizeRedraw |
取得或設定值，指出控制項重設大小時，是否會重繪本身。 (繼承來源 Control) |
| Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| RightToLeftLayout |
取得或設定值，這個值表示是否應從右至左配置 TreeView。 |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| Scrollable |
取得或設定值，指出樹狀檢視控制項是否在必要時顯示捲軸。 |
| SelectedImageIndex |
取得或設定選取樹狀節點時顯示影像的影像清單索引值。 |
| SelectedImageKey |
取得或設定當 TreeNode 位於已選取狀態下時所顯示的預設影像之索引鍵。 |
| SelectedNode |
取得或設定目前在樹狀檢視控制項中選取的樹狀節點。 |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| ShowLines |
取得或設定值，指出是否在樹狀檢閱控制項的樹狀節點之間繪製行。 |
| ShowNodeToolTips |
取得或設定值，指出當滑鼠指標停留於 TreeNode 上時會顯示工具提示。 |
| ShowPlusMinus |
取得或設定值，指出包含子樹狀節點的樹狀節點旁是否顯示加號 (+) 和減號 (-) 按鈕。 |
| ShowRootLines |
取得或設定值，指出是否在位於樹狀檢閱根部的樹狀節點之間繪製行。 |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| Sorted |
取得或設定值，指出是否排序樹狀檢閱中的樹狀節點。 |
| StateImageList |
取得或設定用於表示 TreeView 和其節點之狀態的影像清單。 |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定 TreeView 的文字。 |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 Form。 (繼承來源 Control) |
| TopNode |
取得或設定樹狀檢閱控制項中第一個完整可見的樹狀節點。 |
| TreeViewNodeSorter | |
| UseWaitCursor |
取得或設定值，指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
| Visible |
取得或設定值，這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
| VisibleCount |
取得樹狀檢閱控制項中完整可見的樹狀節點數。 |
| Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
| WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
| AfterCheck |
發生於選取樹狀節點核取方塊之後。 |
| AfterCollapse |
發生於摺疊樹狀節點之後。 |
| AfterExpand |
發生於展開樹狀節點之後。 |
| AfterLabelEdit |
發生於編輯樹狀節點標籤文字之後。 |
| AfterSelect |
發生於選取樹狀節點之後。 |
| AutoSizeChanged |
這個事件與這個類別無關。 (繼承來源 Control) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性變更時。 |
| BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性變更時。 |
| BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性變更時。 (繼承來源 Control) |
| 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 設定時。 (繼承來源 Control) |
| DpiChangedBeforeParent |
發生於某個控制項的父控制項或表單發生 DPI 變更事件之前，以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
| DragDrop |
發生於拖放作業完成時。 (繼承來源 Control) |
| DragEnter |
發生於將物件拖曳至控制項邊框時。 (繼承來源 Control) |
| DragLeave |
發生於將物件拖出控制項界限時。 (繼承來源 Control) |
| DragOver |
發生於將物件拖曳至控制項邊框上方時。 (繼承來源 Control) |
| DrawNode |
在描繪 TreeView 而且 DrawMode 屬性設定為 Normal 以外的 TreeViewDrawMode 值時發生。 |
| 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 |
發生於使用者用滑鼠按一下 TreeNode 時。 |
| NodeMouseDoubleClick |
發生於使用者用滑鼠按兩下 TreeNode 時。 |
| NodeMouseHover |
發生於滑鼠停留於 TreeNode 上方時。 |
| PaddingChanged |
發生於 Padding 屬性的值變更時。 |
| PaddingChanged |
發生於控制項的邊框間距變更時。 (繼承來源 Control) |
| 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) |
明確介面實作
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
