선택 컨트롤 패턴
속성, 메서드 및 이벤트에 대한 정보를 포함하여 ISelectionProvider를 구현하기 위한 지침 및 규칙을 설명합니다. 선택 컨트롤 패턴은 선택 가능한 자식 항목 컬렉션의 컨테이너 역할을 하는 컨트롤을 지원하는 데 사용됩니다. 이 요소의 자식은 ISelectionItemProvider를 구현해야 합니다.
이 컨트롤 패턴을 구현하는 컨트롤의 예는 컨트롤 형식 및 지원되는 컨트롤 패턴을 참조하세요.
이 항목에는 다음과 같은 섹션이 포함되어 있습니다.
구현 지침 및 규칙
선택 컨트롤 패턴을 구현할 때 다음 지침 및 규칙을 확인합니다.
ISelectionProvider를 구현하는 컨트롤을 사용하면 단일 또는 여러 자식 항목을 선택할 수 있습니다. 예를 들어 목록 상자, 목록 보기 및 트리 뷰는 여러 선택을 지원하는 반면 콤보 상자, 슬라이더 및 라디오 단추 그룹은 단일 선택을 지원합니다.
미디어 플레이어의 볼륨 슬라이더 컨트롤과 같이 최소, 최대 및 연속 범위가 있는 컨트롤은 ISelectionProvider 대신 IRangeValueProvider를 구현해야 합니다.
Windows용 디스플레이 속성 대화 상자의 화면 해상도 슬라이더 또는 Microsoft Word 색 선택 컨트롤과 같이 IRawElementProviderFragmentRoot를 구현하는 자식 컨트롤을 관리하는 단일 선택 컨트롤은 ISelectionProvider를 구현해야 합니다. 자식은 IRawElementProviderFragment 및 ISelectionItemProvider를 모두 구현해야 합니다.
메뉴는 선택 컨트롤 패턴을 지원하지 않습니다. 그래픽과 텍스트가 모두 포함된 메뉴 항목(예: Microsoft Outlook의 보기 메뉴에 있는 미리 보기 창 항목)을 사용하고 상태를 전달해야 하는 경우 IToggleProvider를 구현해야 합니다.
ISelectionProvider에 필요한 멤버
ISelectionProvider 인터페이스를 구현하려면 다음 속성, 메서드 및 이벤트가 필요합니다.
| 필요한 멤버 | 멤버 형식 | 참고 |
|---|---|---|
| CanSelectMultiple | 속성 | 없음 |
| IsSelectionRequired | 속성 | 없음 |
| GetSelection | 방법 | 없음 |
| UIA_Selection_InvalidatedEventId | 이벤트 | 컨테이너의 선택 항목이 크게 변경된 경우 이 이벤트를 발생합니다. |
ISelectionProvider::IsSelectionRequired 및 CanSelectMultiple 속성은 동적일 수 있습니다. 예를 들어 컨트롤의 초기 상태에 는 IsSelectionRequired 가 false임을 나타내는 항목이 기본적으로 선택되어 있지 않을 수 있습니다. 그러나 항목이 선택된 후에는 컨트롤에 하나 이상의 항목이 항상 선택되어 있어야 합니다. 마찬가지로, 드문 경우지만 초기화될 때 컨트롤에서 여러 항목이 선택될 수 있지만 이후에는 하나의 선택 항목만 허용됩니다.
관련 항목