다음을 통해 공유


트리 뷰 컨트롤(MSAA UI 요소 참조)

메모

이 항목에서는 MSAA UI 요소 참조를 위해 트리 뷰 컨트롤 개체에 대해 설명합니다. 다양한 UI 프레임워크에서 트리 뷰 컨트롤 개체를 만드는 방법은 여기에 설명되어 있지 않습니다. 사용 중인 UI 프레임워크에 대한 API 참조 설명서를 참조하세요.

트리 뷰 컨트롤은 계층 구조의 관련 항목을 연결하기 위해 선을 사용하여 항목의 계층적 목록을 표시합니다. 각 항목은 레이블과 선택적 비트맵으로 구성됩니다. Windows 탐색기는 트리 뷰 컨트롤을 사용하여 디렉터리를 표시합니다.

트리 뷰 컨트롤의 창 클래스 이름은 WC_TREEVIEW Commctrl.h에서 "SysTreeView"로 정의됩니다.

IAccessible 메서드

트리 뷰 컨트롤은 다음 IAccessible 메서드를 지원합니다.

메서드 코멘트
accDoDefaultAction 트리 뷰 개체 자체에는 accDoDefaultAction 메서드가 없습니다. 트리 뷰에 있는 항목의 상태 속성에 따라 accDoDefaultAction 지정된 항목을 확장하거나 축소할 있습니다.
accHitTest
accLocation
accNavigate
accSelect

IAccessible 속성

트리 뷰 컨트롤은 다음 IAccessible 속성을 지원합니다.

재산 코멘트
get_accChild
get_accChildCount 트리 뷰 개체의 ChildCount 속성은 트리 뷰에 포함된 항목 수입니다. 각 트리 뷰 항목에 대한 ChildCount 속성은 0입니다.
get_accDefaultAction 트리 뷰 개체 자체에는 DefaultAction 속성이 없습니다. 확장되는 트리 뷰의 항목에는 DefaultAction 속성으로 "Collapse"가 있고 확장되지 않은 항목에는 DefaultAction 속성으로 "Expand"가 있습니다.
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName 트리 뷰 개체의 Name 속성은 컨트롤의 창 텍스트(또는 캡션)에서 가져옵니다. 이 텍스트는 트리 뷰 컨트롤과 함께 표시되지 않으므로 서버 개발자는 클라이언트 유틸리티 사용자가 컨트롤을 식별할 수 있도록 컨트롤의 리소스 정의 문에 의미 있는 텍스트를 제공해야 합니다. 트리 뷰의 항목에 대한 Name 속성은 트리 뷰 항목에 표시되는 텍스트입니다.
get_accParent 트리 뷰 개체의 Parent 속성은 컨트롤을 둘러싸고 Name 속성과 창 클래스 이름을 컨트롤과 같은 창(ROLE_SYSTEM_WINDOW)입니다. 트리 뷰에 있는 각 항목의 Parent 속성은 트리 뷰 개체입니다.
get_accRole 트리 뷰 개체에는 Role 속성 ROLE_SYSTEM_OUTLINE있습니다. 트리 뷰의 각 항목에는 Role 속성 ROLE_SYSTEM_OUTLINEITEM있습니다.
get_accSelection
get_accState 트리 뷰에 대한 State 속성은 다음값 중 하나 이상의 조합입니다. STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
트리 뷰 항목의 경우 State 속성에는 STATE_SYSTEM_EXPANDED 또는 STATE_SYSTEM_COLLAPSED포함됩니다.
State 속성에 사용할 수 있는 추가 값은 다음과 같습니다.
STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue 트리 뷰 개체에 값이 없습니다. 각 트리 뷰 항목에 대한 Value 속성은 계층 구조에 있는 항목의 들여쓰기 수준입니다. 예를 들어 Windows 탐색기에서 "Desktop" 항목의 Value 속성은 "0"입니다. 계층 구조의 다음 수준에 있는 항목 "내 컴퓨터"의 Value 속성은 "1"입니다. 계층 구조의 다음 수준에 있는 각 디스크 드라이브의 Value 속성은 "2"입니다.

노트

트리 뷰 항목의 accLocation 속성은 항목에 있는 텍스트의 위치만 반환합니다. 트리 뷰 항목에 대한 accLocation 반환된 좌표에는 텍스트 왼쪽에 있는 아이콘이 포함되지 않습니다.

IAccessible 인터페이스