ISelectionProvider 인터페이스

정의

Microsoft UI 자동화 클라이언트의 액세스를 지원하는 메서드 및 속성을 개별 선택 가능한 자식 항목 컬렉션의 컨테이너 역할을 하는 컨트롤에 노출합니다. 이 요소의 자식 항목은 ISelectionItemProvider를 구현해야 합니다. 자동화 클라이언트가 호출을 통해 요청하는 기능을 지원하기 위해 ISelectionProvider를 GetPattern 구현합니다 PatternInterface.SelectionItem.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.Provider.ISelectionProvider(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public interface class ISelectionProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(520196042, 47428, 17301, 141, 225, 136, 246, 116, 175, 81, 211)]
struct ISelectionProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(520196042, 47428, 17301, 141, 225, 136, 246, 116, 175, 81, 211)]
public interface ISelectionProvider
Public Interface ISelectionProvider
파생
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

이 패턴에는 여기에 완전히 문서화되지 않은 지침 및 규칙이 있습니다. 이 패턴의 대상에 대한 자세한 내용은 선택 컨트롤 패턴을 참조하세요. 그러나 COM 공급자 구현과 관련된 IRawElementProviderFragmentRoot에 대한 지침을 따를 필요는 없으며 인터페이스는 Windows 런타임 자동화 공급자 API에 존재하지 않습니다.

ISelectionProvider는 기본 클래스인 기존 Windows 런타임 클래스SelectorAutomationPeerComboBoxAutomationPeer 의해 구현됩니다ListBoxAutomationPeer.

자동화 이벤트를 발생하거나 호출RaisePropertyChangedEvent할 때 제어 코드에서 ISelectionProvider 패턴 속성을 참조하려는 경우에 사용합니다SelectionPatternIdentifiers.

속성

CanSelectMultiple

Microsoft UI 자동화 공급자가 둘 이상의 자식 요소를 동시에 선택할 수 있는지 여부를 나타내는 값을 가져옵니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.Provider.ISelectionProvider.CanSelectMultiple(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

IsSelectionRequired

UI 자동화 공급자가 하나 이상의 자식 요소를 선택해야 하는지 여부를 나타내는 값을 가져옵니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.Provider.ISelectionProvider.IsSelectionRequired(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

GetSelection()

선택한 각 자식 요소에 대해 UI 자동화 공급자를 검색합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Automation.Provider.ISelectionProvider.GetSelection(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

적용 대상

추가 정보