Control.RemoveFocusEngagement 메서드

정의

네임스페이스:

Windows.UI.Xaml.Controls

포커스 참여가 있는 컨트롤의 컨트롤 경계에서 포커스를 해제합니다(게임 패드/원격 상호 작용용).

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

Windows 요구 사항

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

설명

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

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

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

버전 호환성

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

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

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}