목록 보기 컨트롤(MSAA UI 요소 참조)
참고 항목
이 항목에서는 MSAA UI 요소 참조를 위해 List-View Control 개체에 대해 설명합니다. 다양한 UI 프레임워크에서 목록 보기 컨트롤 개체를 만드는 방법은 여기에 설명되어 있지 않습니다. 사용 중인 UI 프레임워크에 대한 API 참조 설명서를 참조하세요.
목록 보기 컨트롤은 각각 아이콘과 레이블로 구성된 항목 컬렉션을 표시하고 항목을 표시하고 정렬하는 여러 가지 방법을 제공합니다. 예를 들어 각 항목에 대한 추가 정보는 아이콘 및 레이블 오른쪽의 열에 표시됩니다. Windows 탐색기는 목록 보기 컨트롤을 사용하여 파일을 표시합니다.
목록 보기 컨트롤의 창 클래스 이름은 commctrl.h에서 "SysListView"로 정의된 WC_LISTVIEW.
IAccessible 메서드
목록 보기 컨트롤은 다음 IAccessible 메서드를 지원합니다.
| 메서드 | 설명 |
|---|---|
| accDoDefaultAction | list-view 개체 자체에는 DefaultAction 속성이 없습니다. 그러나 accDoDefaultAction 메서드는 목록 보기 항목을 두 번 클릭합니다. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible 속성
목록 보기 컨트롤은 다음 IAccessible 속성을 지원합니다.
| 속성 | 설명 |
|---|---|
| get_accChild | |
| get_accChildCount | ChildCount 속성은 목록의 항목 수입니다. |
| get_accDefaultAction | 목록 보기 개체 자체에는 DefaultAction 속성이 없습니다. 그러나 각 목록 보기 항목에 대한 DefaultAction 속성은 "두 번 클릭"입니다. |
| get_accDescription | 목록 보기 개체 자체는 Description 속성을 지원하지 않지만 각 목록 보기 항목에 대한 Description 속성은 항목의 두 번째 및 후속 열에 포함된 텍스트입니다. 각 열의 텍스트 사이에 쉼표가 삽입됩니다. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | 목록 보기 개체에는 바로 가기 키가 없습니다. 그러나 목록 보기 컨트롤의 창 텍스트에 앰퍼샌드(&) 문자가 포함된 경우 Microsoft Active Accessibility는 Null이 아닌 문자열을 KeyboardShortcut 속성으로 반환합니다. |
| get_accName | 목록 보기 개체의 이름은 컨트롤의 창 텍스트(또는 캡션)에서 가져옵니다. 이 텍스트는 목록 보기 컨트롤과 함께 표시되지 않으므로 서버 개발자는 클라이언트 유틸리티 사용자가 컨트롤을 식별할 수 있도록 컨트롤의 리소스 정의 문에 의미 있는 텍스트를 제공해야 합니다. 목록 보기 항목의 경우 Name 속성은 목록 항목의 텍스트입니다. |
| get_accParent | 목록 보기 개체의 부모는 컨트롤을 둘러싸고 컨트롤과 Name 속성 및 창 클래스 이름이 같은 창(ROLE_SYSTEM_WINDOW)입니다. 목록 보기 항목의 Parent 속성은 list-view 개체입니다. |
| get_accRole | ROLE_SYSTEM_LIST 역할 및 목록 보기 컨트롤의 각 항목에는 ROLE_SYSTEM_LISTITEM Role 속성이 있습니다. |
| get_accSelection | |
| get_accState | 목록 보기 개체의 State 속성은 다음 값 중 하나 이상의 조합입니다. STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_OFFSCREEN | | 목록 보기 항목의 State 속성은 다음 값 중 하나 이상의 조합입니다. | STATE_SYSTEM_INVISIBLE STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL | | 또한 검사 상자 목록 보기 항목에도 상태 STATE_SYSTEM_CHECKED 있습니다. |
주의
- Microsoft Active Accessibility는 콜백 함수를 사용하여 항목에 텍스트를 추가하는 애플리케이션에서 목록 보기 항목 텍스트를 노출하지 않습니다.
- 잘린 목록 보기 항목에는 STATE_SYSTEM_INVISIBLE 설정되지 않았습니다. 목록 항목이 잘렸는지 확인하기 위해 클라이언트는 accLocation에서 반환된 항목의 좌표를 창의 클리핑 영역과 비교할 수 있습니다.
- Microsoft Active Accessibility는 accNavigate 메서드를 사용하여 세부 정보 보기에 있는 목록 보기 컨트롤 내에서 헤더 컨트롤로 이동하는 것을 지원하지 않습니다. 그러나 클라이언트는 AccessibleObjectFromPoint 함수를 사용하여 헤더 컨트롤에 액세스합니다.
- 세부 정보 보기의 목록 보기 항목과 같은 직사각형이 아닌 개체의 경우 accHitTest가 픽셀 단위로 개체의 경계를 결정하므로 accHitTest로 테스트하면 accLocation에 의해 검색된 항목의 경계 사각형의 좌표가 실패합니다.