TreeView 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

중첩된 항목이 포함된 노드를 확장하거나 축소하는 계층 구조 목록을 나타냅니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TreeView : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TreeView : Control

Public Class TreeView
Inherits Control

상속

Control

TreeView

특성

MarshalingBehaviorAttribute ThreadingAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute

예제

팁

자세한 정보, 디자인 지침 및 코드 예제는 트리 뷰를 참조하세요.

WinUI 2 갤러리 앱을 열고 작동 중인 TreeView를 참조하세요.

WinUI 2 갤러리 앱에는 대부분의 WinUI 2 컨트롤, 특징, 기능의 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub에서 소스 코드를 가져오세요.

설명

컨트롤 스타일 및 템플릿

기본 스타일 및 ControlTemplate 을 수정하여 컨트롤에 고유한 모양을 지정할 수 있습니다. 컨트롤의 스타일 및 템플릿을 수정하는 방법에 대한 자세한 내용은 XAML 스타일을 참조하세요. 컨트롤의 모양을 정의하는 기본 스타일, 템플릿 및 리소스가 파일에 포함 generic.xaml 됩니다. 디자인 목적으로 는 generic.xaml WinUI(Microsoft.UI.Xaml) NuGet 패키지와 함께 설치됩니다. 기본적으로 이 위치는 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml입니다. 다른 버전의 WinUI의 스타일 및 리소스에는 다른 값이 있을 수 있습니다.

XAML에는 컨트롤 템플릿을 수정하지 않고 다른 시각적 상태에서 컨트롤의 색을 수정하는 데 사용할 수 있는 리소스도 포함되어 있습니다. 이러한 리소스를 수정하는 것은 Background 및 Foreground와 같은 속성을 설정하는 것이 좋습니다. 자세한 내용은 XAML 스타일 문서의 경량 스타일 섹션을 참조하세요.

생성자

TreeView()

TreeView 컨트롤의 새 instance 초기화합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

속성

CanDragItems	뷰의 항목을 데이터 페이로드로 끌 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CanDragItemsProperty	CanDragItems 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CanReorderItems	사용자 상호 작용을 통해 뷰의 항목을 다시 정렬할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CanReorderItemsProperty	CanReorderItems 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerStyle	항목 컨테이너를 렌더링할 때 사용되는 스타일을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerStyleProperty	ItemContainerStyle 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerStyleSelector	사용자 지정 StyleSelector 논리 클래스에 대한 참조를 가져오거나 설정합니다. StyleSelector는 표시되는 개체의 특성에 따라 항목 컨테이너에 사용할 다양한 Style 값을 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerStyleSelectorProperty	ItemContainerStyleSelector 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerTransitions	TreeView의 항목 컨테이너에 적용되는 전환 스타일 요소의 컬렉션을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemContainerTransitionsProperty	ItemContainerTransitions 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemsSource	TreeView의 콘텐츠를 생성하는 데 사용되는 개체 원본을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemsSourceProperty	ItemsSource 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemTemplate	각 항목을 표시하는 데 사용되는 DataTemplate 을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemTemplateProperty	ItemTemplate 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemTemplateSelector	사용자 지정 DataTemplateSelector 논리 클래스에 대한 참조를 가져오거나 설정합니다. 이 속성에서 참조하는 DataTemplateSelector는 항목에 적용할 템플릿을 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemTemplateSelectorProperty	ItemTemplateSelector 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
RootNodes	트리의 루트 노드 컬렉션을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectedItem	TreeView의 SelectedItem 속성을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectedItemProperty	SelectedItem 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectedItems	현재 선택한 항목을 가져옵니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectedNode	트리에서 선택된 노드를 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectedNodes	트리에서 선택된 노드의 컬렉션을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectionMode	TreeView instance 대한 선택 동작을 가져오거나 설정합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectionModeProperty	SelectionMode 종속성 속성을 식별합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

Collapse(TreeViewNode)	트리에서 지정된 노드를 축소합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ContainerFromItem(Object)	지정된 항목에 해당하는 컨테이너를 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ContainerFromNode(TreeViewNode)	지정된 노드에 해당하는 컨테이너를 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Expand(TreeViewNode)	트리에서 지정된 노드를 확장합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemFromContainer(DependencyObject)	지정된 생성된 컨테이너에 해당하는 항목을 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
NodeFromContainer(DependencyObject)	지정된 컨테이너에 해당하는 TreeViewNode를 반환합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SelectAll()	트리의 모든 노드를 선택합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

이벤트

Collapsed	트리의 노드가 축소될 때 발생합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
DragItemsCompleted	보기의 항목 중 하나를 포함하는 끌기 작업이 종료되면 발생합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
DragItemsStarting	보기의 항목 중 하나를 포함하는 끌기 작업이 시작될 때 발생합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Expanding	트리의 노드가 확장하기 시작할 때 발생합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ItemInvoked	트리의 항목이 호출될 때 발생합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

• TreeViewCollapsedEventArgs
• TreeViewDragItemsCompletedEventArgs
• TreeViewDragItemsStartingEventArgs
• TreeViewExpandingEventArgs
• TreeViewItem
• TreeViewItemInvokedEventArgs
• TreeViewItemTemplateSettings
• TreeViewList
• TreeViewNode
• TreeViewSelectionMode
• TreeView 개요