다음을 통해 공유

Control.RequiresPointer 속성

  • 참조

정의

네임스페이스:
Windows.UI.Xaml.Controls
편집

UI 요소가 게임 패드 또는 원격 제어와 같은 비 포인터 입력 디바이스를 사용하여 포인터 상호 작용 환경을 에뮬레이트하는 마우스 모드를 지원하는지 여부를 가져오거나 설정합니다.

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };
RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);
public RequiresPointer RequiresPointer { get; set; }
var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;
Public Property RequiresPointer As RequiresPointer
<control RequiresPointer="requiresPointerMemberName"/>

속성 값

RequiresPointer

포인터 에뮬레이션 모드입니다. 기본값은 Never입니다.

Windows 요구 사항

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

설명

비 포인터 입력 장치의 경우 키보드의 Tab 및 화살표 키, 원격의 방향 패드(D 패드) 또는 게임 컨트롤러의 엄지 스틱과 같은 다양한 방법을 통해 컨트롤 간에 포커스가 이동합니다. 지도 및 그리기 표면과 같은 일부 사용자 환경의 경우 XY 포커스 탐색을 사용할 수 없거나 실용적이지 않습니다. RequiresPointer를 사용하면 앱에서 게임 입력 장치를 사용하여 자유롭게 이동할 수 있는 커서를 통해 포인터와 유사한 상호 작용 환경을 제공할 수 있습니다.

RequiresPointer는 Xbox 장치 패밀리에서만 지원되며 게임 패드 또는 리모컨을 사용하는 경우에만 지원됩니다. 그렇지 않으면 속성이 무시됩니다.

RequiresPointerMode 는 애플리케이션 수준에서 마우스 모드를 설정합니다.

자세한 내용은 Xbox 및 TV용 디자인의 마우스 모드 섹션을 참조하세요.

버전 호환성

RequiresPointer 속성은 Windows 10 버전 1607 이전에는 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용 하 여 설정 하기 전에이 속성의 존재에 대 한 검사 하는 방법을 보여 집니다.

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

적용 대상

추가 정보