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 메서드 및 EndUpdate 메서드를 BeginUpdate 사용하여 표시되지 않으며 개체를 만들고 그리는 동안 TreeView 대기 Cursor 가 TreeNode 표시됩니다. 이 예제에서는 Customer 개체 컬렉션을 Order 보유할 수 있는 개체가 있어야 합니다. 또한 애플리케이션 디렉터리에 이름이 지정 MyWait.cur 되고 컨트롤의 TreeView 인스턴스를 만든 커서 파일이 있어야 합니다 Form.
// 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 확인할 수 있습니다.
속성에 할당하고 ImageListImageList 할당할 인덱스 값을 ImageImageList 참조하여 트리 노드 옆에 이미지를 표시할 수 있습니다 Image. 다음 속성을 사용하여 이미지를 할당합니다.
ImageIndex 트리 노드를 선택하지 않을 때 표시할 인덱스 값 Image 으로 속성을 설정합니다.
SelectedImageIndex 트리 노드를 선택할 때 표시할 인덱스 값 Image 으로 속성을 설정합니다.
및 SelectedImageIndex 속성 값에서 ImageIndex 참조하는 이미지는 컬렉션에 할당된 Nodes 모든 트리 노드에서 표시하는 기본 이미지입니다. 개별 트리 노드는 및 TreeNode.SelectedImageIndex 속성을 설정하여 기본 이미지를 재정의할 TreeNode.ImageIndex 수 있습니다.
기본적으로 16 x 16 픽셀에 표시되는 TreeView 상태 이미지입니다. 속성을 ImageSizeStateImageList 설정해도 이미지가 표시되는 방식에는 영향을 주지 않습니다. 그러나 app.config 파일에 다음 항목이 포함된 경우 시스템 DPI 설정에 따라 상태 이미지의 크기가 조정됩니다.
<appSettings>
<add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>
트리 노드를 확장하여 다음 수준의 자식 트리 노드를 표시할 수 있습니다. 사용자가 더하기 기호(+) 단추를 클릭하여 확장 TreeNode 할 수 있습니다. 이 단추가 옆에 TreeNode표시되는 경우 또는 메서드를 호출 TreeNode.Expand 하여 확장할 TreeNode 수 있습니다. 컬렉션의 모든 자식 트리 노드 수준을 Nodes 확장하려면 메서드를 호출합니다 ExpandAll . 메서드를 호출 TreeNode.Collapse 하여 자식 TreeNode 수준을 축소하거나 옆에 표시되는 TreeNode경우 사용자가 빼기 기호(-) 단추를 누를 수 있습니다. 확장된 상태와 축소된 상태를 번갈아 가며 메서드를 호출 TreeNode.Toggle 할 수도 있습니다.
트리 노드는 필요에 따라 확인란을 표시할 수 있습니다. 확인란을 표시하려면 to의 CheckBoxesTreeViewtrue속성을 설정합니다. 이 Checked 속성은 선택된 상태에 있는 트리 노드에 대해 설정 true 됩니다.
메모
TreeNode.Checked 또는 AfterCheck 이벤트 내에서 BeforeCheck 속성을 설정하면 이벤트가 여러 번 발생하고 예기치 않은 동작이 발생할 수 있습니다. 예를 들어 사용자가 각 노드를 Checked 개별적으로 확장하고 확인할 필요가 없도록 자식 노드를 재귀적으로 업데이트할 때 이벤트 처리기에서 속성을 설정할 수 있습니다. 이벤트가 여러 번 발생하지 않도록 하려면 해당 속성 Action 이 설정TreeViewEventArgs되지 않은 경우에만 TreeViewAction.Unknown 재귀 코드를 실행하는 논리를 이벤트 처리기에 추가합니다. 이 작업을 수행하는 방법에 대한 예제는 또는 BeforeCheck 이벤트의 예제 섹션을 AfterCheck 참조하세요.
컨트롤의 TreeView 표시 및 스타일 속성 중 일부를 설정하여 컨트롤의 모양을 변경할 수 있습니다. 각각 확장하거나 축소할 수 있는 각각 TreeNode 옆에 더하기 기호 또는 빼기 기호 단추를 표시하도록 true 설정합니다ShowPlusMinus.
ShowRootLines 속성을 설정하면 true 모든 루트 트리 노드를 TreeView 함께 조인하는 선이 표시됩니다. 속성을 로 설정 ShowLines 하여 자식 트리 노드를 루트 노드에 연결하는 줄을 표시할 true수 있습니다.
HotTracking 속성을 설정하면 true 마우스 포인터가 트리 노드 레이블을 통과할 때 트리 노드 레이블의 모양이 변경됩니다. 핫 추적 시 트리 노드 레이블은 하이퍼링크의 모양을 사용합니다. 컨트롤의 TreeView 모양을 완전히 사용자 지정할 수도 있습니다. 이렇게 하려면 속성을 이외의 TreeViewDrawMode.Normal 값으로 설정하고 DrawMode 이벤트를 처리합니다DrawNode.
메모
런타임 TreeView 에 CheckBoxes, Scrollable, ImageIndex및 SelectedImageIndex 속성을 설정할 때 컨트롤의 모양을 업데이트하기 위해 핸들이 다시 만들어집니다(참조Control.RecreateHandle). 이렇게 하면 선택한 트리 노드를 제외한 모든 트리 노드가 축소됩니다 TreeNode.
생성자
| Name | Description |
|---|---|
| TreeView() |
TreeView 클래스의 새 인스턴스를 초기화합니다. |
속성
| Name | 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 |
IME 지원을 사용하도록 설정하기 위해 속성을 활성 값으로 설정할 수 있는지 여부를 ImeMode 나타내는 값을 가져옵니다. (다음에서 상속됨 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 |
컨트롤에 연결된 핸들이 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 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) |
| RightToLeftLayout |
오른쪽에서 왼쪽으로 배치해야 하는지 여부를 TreeView 나타내는 값을 가져오거나 설정합니다. |
| ScaleChildren |
자식 컨트롤의 크기를 결정하는 값을 가져옵니다. (다음에서 상속됨 Control) |
| Scrollable |
트리 뷰 컨트롤이 필요할 때 스크롤 막대를 표시하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| SelectedImageIndex |
트리 노드를 선택할 때 표시되는 이미지의 이미지 목록 인덱스 값을 가져오거나 설정합니다. |
| SelectedImageKey |
선택한 상태일 때 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) |
메서드
이벤트
| Name | 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 |
속성이 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 속성 값이 변경되면 발생합니다. |
| 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) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop 이벤트를 발생시킵니다. (다음에서 상속됨 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter 이벤트를 발생시킵니다. (다음에서 상속됨 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave 이벤트를 발생시킵니다. (다음에서 상속됨 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
DragOver 이벤트를 발생시킵니다. (다음에서 상속됨 Control) |
