UI 자동화 SelectionItem 컨트롤 패턴 구현

참고
이 문서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI Automation 클래스를 사용하려는 .NET Framework 개발자를 위해 작성되었습니다.UI Automation에 대한 최신 정보는 Windows Automation API: UI Automation을 참조하십시오.

이 항목에서는 속성, 메서드 및 이벤트에 대한 정보를 포함하여 ISelectionItemProvider 구현에 대한 지침 및 규칙을 소개합니다. 추가 참조에 대한 링크는 개요 끝 부분에 나와 있습니다.

SelectionItemPattern 컨트롤 패턴은 ISelectionProvider를 구현하는 컨테이너 컨트롤의 선택 가능한 개별 자식 항목의 기능을 하는 컨트롤을 지원하는 데 사용합니다. SelectionItem 컨트롤 패턴을 구현하는 컨트롤 예제를 보려면 UI 자동화 클라이언트에 대한 컨트롤 패턴 매핑을 참조하십시오.

이 항목에는 다음 단원이 포함되어 있습니다.

구현 지침 및 규칙

Selection Item 컨트롤 패턴을 구현하는 경우 다음 지침 및 규칙을 따르십시오.

디스플레이 속성 대화 상자의 화면 해상도 슬라이더와 같이 IRawElementProviderFragmentRoot를 구현하는 자식 컨트롤을 관리하는 단일 선택 컨트롤은 ISelectionProvider를 구현해야 하고 이 컨트롤의 자식 항목은 IRawElementProviderFragment와 ISelectionItemProvider를 모두 구현해야 합니다.

ISelectionItemProvider 구현에 필요한 속성, 메서드 및 이벤트는 다음과 같습니다.

필수 멤버	멤버 형식	참고
CanSelectMultiple	Property	없음
IsSelectionRequired	Property	없음
GetSelection	메서드	없음
InvalidatedEvent	Event	컨테이너 내의 선택이 크게 변경되어 InvalidateLimit 상수가 허용하는 것보다 많은 ElementSelectedEvent 및 ElementRemovedFromSelectionEvent 이벤트를 전송해야 하는 경우 발생합니다.

Select, AddToSelection 또는 RemoveFromSelection의 결과로 단일 항목이 선택되는 경우에는 ElementSelectedEvent가 발생하고, 그렇지 않은 경우에는 상황에 따라 ElementAddedToSelectionEvent 또는 ElementRemovedFromSelectionEvent를 전송합니다.

공급자는 다음 예외를 throw해야 합니다.

예외 형식	조건
InvalidOperationException	다음 중 하나라도 시도된 경우 IsSelectionRequiredProperty가 true이고 요소가 이미 선택되어 있는 단일 선택 컨테이너에 대해 RemoveFromSelection이 호출된 경우 IsSelectionRequiredProperty가 true이고 선택된 요소가 하나뿐인 다중 선택 컨테이너에 대해 RemoveFromSelection이 호출된 경우 CanSelectMultipleProperty가 false이고 다른 요소가 이미 선택되어 있는 단일 선택 컨테이너에 대해 AddToSelection가 호출된 경우

다음 중 하나라도 시도된 경우

IsSelectionRequiredProperty가 true이고 요소가 이미 선택되어 있는 단일 선택 컨테이너에 대해 RemoveFromSelection이 호출된 경우
IsSelectionRequiredProperty가 true이고 선택된 요소가 하나뿐인 다중 선택 컨테이너에 대해 RemoveFromSelection이 호출된 경우
CanSelectMultipleProperty가 false이고 다른 요소가 이미 선택되어 있는 단일 선택 컨테이너에 대해 AddToSelection가 호출된 경우