Control.IsFocusEngaged 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

컨트롤 경계 내에서 포커스가 제한되는지 여부를 나타내는 값을 얻거나 설정합니다(게임 패드/원격 상호 작용의 경우).

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

bool IsFocusEngaged();

void IsFocusEngaged(bool value);

public bool IsFocusEngaged { get; set; }

var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;

Public Property IsFocusEngaged As Boolean

<control IsFocusEngaged="bool"/>

속성 값

Boolean

bool

포커스가 컨트롤 경계 내에서 제한되면 true이고, 그렇지 않으면 false입니다.

Windows 요구 사항

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

설명

IsFocusEngagementEnabled 는 true 여야 하며 IsFocusEngaged 속성을 true로 설정하기 전에 컨트롤에 포커스가 있어야 합니다. 그렇지 않으면 런타임 예외가 발생합니다.

포커스 참여를 사용하면 게임 패드 또는 리모컨을 사용하여 앱과 상호 작용하는 것이 더 쉬워집니다. 포커스 참여를 설정해도 키보드 또는 기타 입력 장치에는 영향을 주지 않습니다.

IsFocusEngagementEnabled 속성이 true로 설정되면 컨트롤을 포커스 연결이 필요한 것으로 표시합니다. 즉, 사용자가 A/선택 단추를 눌러 컨트롤을 "연결"하고 조작해야 합니다. 작업이 완료되면 B/뒤로 단추를 눌러 컨트롤을 분리하고 해당 컨트롤에서 벗어날 수 있습니다.

이 속성에 대한 자세한 내용은 Xbox 및 TV용 디자인 문서의 포커스 참여 섹션을 참조하세요.

버전 호환성

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

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

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngaged"))
{
    slider1.IsFocusEngaged = true;
}