선택 컨트롤 패턴
속성, 메서드 및 이벤트에 대한 정보를 포함하여 ISelectionProvider구현하기 위한 지침 및 규칙에 대해 설명합니다. 선택 컨트롤 패턴은 선택 가능한 자식 항목 컬렉션의 컨테이너 역할을 하는 컨트롤을 지원하는 데 사용됩니다. 이 요소의 자식은 ISelectionItemProvider구현해야 합니다.
이 컨트롤 패턴을 구현하는 컨트롤의 예제는 컨트롤 형식 및 지원되는 컨트롤 패턴참조하세요.
이 항목에는 다음 섹션이 포함되어 있습니다.
- 구현 지침 및 규칙
- ISelectionProvider필요한 멤버
- 관련 항목
구현 지침 및 규칙
Selection 컨트롤 패턴을 구현하는 경우 다음 지침 및 규칙을 확인합니다.
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임을 나타냅니다. 그러나 항목을 선택한 후에는 컨트롤에 항상 하나 이상의 항목이 선택되어 있어야 합니다. 마찬가지로, 드문 경우지만 컨트롤을 사용하면 초기화 시 여러 항목을 선택할 수 있지만 이후에는 단일 항목만 선택할 수 있습니다.
관련 항목