ListItem 컨트롤 형식에 대한 UI 자동화 지원
![]() |
---|
이 문서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI Automation 클래스를 사용하려는 .NET Framework 개발자를 위해 작성되었습니다.UI Automation에 대한 최신 정보는 Windows Automation API: UI Automation을 참조하십시오. |
이 항목에서는 ListItem 컨트롤 형식에 대한 UI Automation 지원 관련 정보를 제공합니다. UI Automation에서 컨트롤 형식은 컨트롤이 ControlTypeProperty 속성을 사용하기 위해 만족해야 하는 조건 집합입니다. 조건에는 UI Automation 트리 구조, UI Automation 속성 값 및 컨트롤 패턴에 대한 지침이 포함됩니다.
목록 항목 컨트롤은 ListItem 컨트롤 형식을 구현하는 컨트롤의 예입니다.
다음 단원에서는 ListItem 컨트롤 형식의 필수 UI Automation 트리 구조, 속성, 컨트롤 패턴 및 이벤트를 정의합니다. UI Automation 요구 사항은 Windows Presentation Foundation (WPF), Win32, Windows Forms에 관계없이 모든 목록 컨트롤에 적용됩니다.
이 항목에는 다음 단원이 포함되어 있습니다.
- 필수 UI 자동화 트리 구조
- 필수 UI 자동화 속성
- 필수 UI 자동화 컨트롤 패턴
- 필수 UI 자동화 이벤트
- 관련 항목
필수 UI 자동화 트리 구조
다음 표에서는 목록 항목 컨트롤과 관계가 있는 UI Automation 트리의 컨트롤 뷰 및 콘텐츠 뷰를 보여 주며 각 뷰에 포함될 수 있는 항목에 대해 설명합니다. UI Automation 트리에 대한 자세한 내용은 UI 자동화 트리 개요를 참조하십시오.
컨트롤 뷰 |
콘텐츠 뷰 |
---|---|
ListItem
|
ListItem |
UI Automation 트리의 콘텐츠 뷰 내에 있는 목록 항목 컨트롤의 자식 항목은 항상 "0"개여야 합니다. 컨트롤의 구조상 목록 항목 아래에 다른 항목이 포함되는 경우에는 TreeItem 컨트롤 형식에 대한 UI 자동화 지원 요구 사항을 따라야 합니다.
필수 UI 자동화 속성
다음 표에서는 값이나 정의가 특히 목록 항목 컨트롤에 관련된 UI Automation 속성을 보여 줍니다. UI Automation 속성에 대한 자세한 내용은 클라이언트의 UI 자동화 속성를 참조하십시오.
UI Automation 속성 |
값 |
참고 |
---|---|---|
설명을 참조하십시오. |
이 속성의 값은 응용 프로그램의 모든 컨트롤에서 고유해야 합니다. |
|
설명을 참조하십시오. |
이 속성의 이 값에 목록 항목의 텍스트 콘텐츠와 이미지 영역이 모두 포함되어야 합니다. |
|
상황에 따라 다름 |
목록 컨트롤에 클릭 가능한 지점(목록으로 포커스가 이동되도록 클릭 가능한 지점)이 있는 경우 해당 지점은 이 속성을 통해 노출됩니다. 목록 항목이 하위 목록 항목으로 완전히 가려지는 경우 NoClickablePointException을 발생시켜 클라이언트가 목록 컨트롤 내의 항목에 대해 클릭 가능한 지점을 요청해야 함을 나타냅니다. |
|
설명을 참조하십시오. |
목록 항목 컨트롤의 이름 속성 값을 항목의 텍스트 콘텐츠에서 가져옵니다. |
|
설명을 참조하십시오. |
정적 텍스트 레이블이 있는 경우 이 속성은 해당 컨트롤에 대한 참조를 노출해야 합니다. |
|
ListItem |
이 값은 모든 UI 프레임워크에서 동일합니다. |
|
"목록 항목" |
ListItem 컨트롤 형식에 해당하는 지역화된 문자열입니다. |
|
True |
목록 컨트롤이 항상 UI Automation 트리의 콘텐츠 뷰에 포함됩니다. |
|
True |
목록 컨트롤이 항상 UI Automation 트리의 컨트롤 뷰에 포함됩니다. |
|
True |
컨테이너가 키보드 입력을 받을 수 있으려면 이 속성 값이 true여야 합니다. |
|
"" |
목록 컨트롤의 도움말 텍스트는 일반적으로 도구 설명을 통해 제공되는 정보와 동일한 형식인 옵션 목록에서 항목을 선택하도록 사용자에게 요청하는 이유를 설명해야 합니다. 예를 들어, "사용자 모니터의 디스플레이 해상도가 설정하려면 항목을 선택합니다."와 같은 도움말 텍스트가 있을 수 있습니다. |
|
상황에 따라 다름 |
이 속성은 기본 개체를 나타내는 목록 항목 컨트롤에 대해 노출되어야 합니다. 일반적으로 이러한 목록 항목 컨트롤에는 사용자가 기본 개체와 연결하는 컨트롤에 연결된 아이콘이 있습니다. |
|
상황에 따라 다름 |
이 속성은 Scroll 컨트롤 패턴을 구현하는 부모 컨테이너 내에서 목록 항목이 현재 표시되도록 스크롤되는지 여부를 나타내는 값을 반환해야 합니다. |
필수 UI 자동화 컨트롤 패턴
다음 표에서는 목록 항목 컨트롤이 지원해야 하는 UI Automation 컨트롤 패턴을 보여 줍니다. 컨트롤 패턴에 대한 자세한 내용은 UI 자동화 컨트롤 패턴 개요를 참조하십시오.
컨트롤 패턴 |
지원 |
참고 |
---|---|---|
예 |
목록 항목 컨트롤이 이 컨트롤 패턴을 구현해야 합니다. 그래야 목록 항목 컨트롤이 선택된 경우 이를 알릴 수 있습니다. |
|
상황에 따라 다름 |
목록 항목이 스크롤 가능한 컨테이너 내에 포함되려면 이 컨트롤 패턴을 구현해야 합니다. |
|
상황에 따라 다름 |
목록 항목이 선택 가능하고 선택 작업으로 선택 상태 변경이 수행되지 않도록 하려면 이 컨트롤 패턴을 구현해야 합니다. |
|
상황에 따라 다름 |
정보를 표시하거나 숨기도록 항목을 조작할 수 있으려면 이 컨트롤 패턴을 구현해야 합니다. |
|
상황에 따라 다름 |
항목을 편집할 수 있으려면 이 컨트롤 패턴을 구현해야 합니다. 목록 항목 컨트롤이 변경되면 NameProperty의 값과 Value가 변경됩니다. |
|
상황에 따라 다름 |
컨테이너가 행과 열로 정렬된 경우 목록 컨테이너 내의 항목 간 탐색을 지원하려면 Grid Item 컨트롤 패턴을 구현해야 합니다. |
|
상황에 따라 다름 |
항목 선택 외의 명령을 항목에 대해 수행할 수 있으려면 이 패턴을 구현해야 합니다. 대개 목록 항목 컨트롤을 두 번 클릭하는 것과 관련된 작업입니다. Microsoft Windows Explorer에서 문서를 시작하거나 Microsoft Windows Media Player에서 음악 파일을 재생하는 것을 예로 들 수 있습니다. |
필수 UI 자동화 이벤트
다음 표에서는 모든 목록 항목 컨트롤이 지원해야 하는 UI Automation 이벤트를 보여 줍니다. 이벤트에 대한 자세한 내용은 UI 자동화 이벤트 개요를 참조하십시오.
UI Automation 이벤트 |
지원 |
참고 |
---|---|---|
상황에 따라 다름 |
없음 |
|
필수 |
없음 |
|
필수 |
없음 |
|
필수 |
없음 |
|
BoundingRectangleProperty 속성 변경 이벤트 |
필수 |
없음 |
IsOffscreenProperty 속성 변경 이벤트 |
필수 |
없음 |
IsEnabledProperty 속성 변경 이벤트 |
필수 |
없음 |
필수 |
없음 |
|
ItemStatusProperty 속성 변경 이벤트 |
상황에 따라 다름 |
없음 |
ExpandCollapseStateProperty 속성 변경 이벤트 |
상황에 따라 다름 |
없음 |
ValueProperty 속성 변경 이벤트 |
상황에 따라 다름 |
없음 |
ToggleStateProperty 속성 변경 이벤트 |
상황에 따라 다름 |
없음 |
필수 |
없음 |
|
필수 |
없음 |