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