선택 컨트롤 패턴

  • 아티클

속성, 메서드 및 이벤트에 대한 정보를 포함하여 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임을 나타내는 항목이 기본적으로 선택되어 있지 않을 수 있습니다. 그러나 항목이 선택된 후에는 컨트롤에 하나 이상의 항목이 항상 선택되어 있어야 합니다. 마찬가지로, 드문 경우지만 초기화될 때 컨트롤에서 여러 항목이 선택될 수 있지만 이후에는 하나의 선택 항목만 허용됩니다.

컨트롤 형식 및 해당 지원되는 컨트롤 패턴

SelectionItem 컨트롤 패턴

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요