UI 자동화 SelectionItem 컨트롤 패턴 구현
참고 항목
이 설명서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI 자동화 클래스를 사용하려는 .NET Framework 개발자를 위한 것입니다. UI 자동화에 대한 최신 정보는 Windows 자동화 API: UI 자동화를 참조하세요.
이 항목에서는 속성, 메서드 및 이벤트에 대한 정보를 포함하여 ISelectionItemProvider를 구현하기 위한 지침 및 규칙을 제공합니다. 추가 참조에 대한 링크는 개요의 끝에 나열되어 있습니다.
SelectionItemPattern 컨트롤 패턴은 ISelectionProvider를 구현하는 컨테이너 컨트롤의 선택 가능한 개별 자식 항목 역할을 하는 컨트롤을 지원하는 데 사용됩니다. SelectionItem 컨트롤 패턴을 구현하는 컨트롤의 예제를 보려면 UI 자동화 클라이언트에 대한 컨트롤 패턴 매핑을 참조하세요.
구현 지침 및 규칙
Selection Item 컨트롤 패턴을 구현할 때는 다음 지침 및 규칙에 유의하세요.
- IRawElementProviderFragmentRoot표시 속성 대화 상자의 화면 해상도 슬라이더와 같이 를 구현하는 자식 컨트롤을 관리하는 단일 선택 컨트롤은 ISelectionProvider 를 구현해야 하며, 해당 자식 항목은 IRawElementProviderFragment 및 ISelectionItemProvider둘 다 구현해야 합니다.
ISelectionItemProvider에 필요한 멤버
ISelectionItemProvider를 구현하려면 다음과 같은 속성, 메서드 및 이벤트가 필요합니다.
| 필수 멤버 | 멤버 형식 | 주의 |
|---|---|---|
| CanSelectMultiple | 속성 | None |
| IsSelectionRequired | 속성 | None |
| GetSelection | 메서드 | None |
| InvalidatedEvent | 이벤트 | 컨테이너의 선택 항목이 현저히 변경되어 ElementSelectedEvent 상수가 허용하는 것보다 더 많은 ElementRemovedFromSelectionEvent 및 InvalidateLimit 이벤트를 보내야 하는 경우에 발생합니다. |
- Select, AddToSelection 또는 RemoveFromSelection의 결과로 단일 항목이 선택되는 경우 ElementSelectedEvent가 발생해야 합니다. 그렇지 않을 경우 ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent를 적절히 보냅니다.
예외
공급자는 다음과 같은 예외를 throw해야 합니다.
| 예외 종류 | 조건 |
|---|---|
| InvalidOperationException | 다음 중 하나가 시도되는 경우: - RemoveFromSelection 이 IsSelectionRequiredProperty = true 이고 요소가 이미 선택되어 있는 단일 선택 컨테이너에 호출되는 경우.- RemoveFromSelection 이 IsSelectionRequiredProperty = true 이고 요소가 하나만 선택된 다중 선택 컨테이너에 호출되는 경우.- AddToSelection 이 CanSelectMultipleProperty = false 이고 다른 요소가 이미 선택된 단일 선택 컨테이너에 호출되는 경우. |