ListBox.SingleSelectionFollowsFocus 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

키보드 포커스가 변경되면 항목 선택이 변경되는지 여부를 나타내는 값을 가져오거나 설정합니다.

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

bool SingleSelectionFollowsFocus();

void SingleSelectionFollowsFocus(bool value);

public bool SingleSelectionFollowsFocus { get; set; }

var boolean = listBox.singleSelectionFollowsFocus;
listBox.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<ListBox SingleSelectionFollowsFocus="bool" />

속성 값

Boolean

bool

키보드 포커스가 변경되면 항목 선택이 변경되면 true입니다. 그렇지 않으면 false입니다. 기본값은 true입니다.

Windows 요구 사항

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

설명

목록 상자의 SelectionMode 속성이 Single로 설정되지 않은 경우 이 속성은 무시됩니다.

기본적으로 목록 상자가 단일 선택 영역으로 구성된 경우 사용자가 키보드 포커스를 항목으로 이동하면 포커스가 있는 항목도 선택됩니다. 예를 들어 키보드 포커스가 첫 번째 항목에서 두 번째 항목으로 이동되면 SelectedIndex 속성이 0에서 1로 업데이트됩니다.

다음 항목을 선택하지 않고 포커스를 이동할 수 있도록 하려면 이 속성을 false 로 설정합니다. 예를 들어 각 선택 변경으로 인해 중요한 UI 업데이트가 발생하는 경우 사용자가 인접하지 않은 항목으로 포커스를 이동한 다음 Enter 키를 눌러 선택 항목을 업데이트할 수 있습니다.

버전 호환성

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

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

<ListBox x:Name="listBox1" Loaded="ListBox_Loaded"/>

private void ListBox_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ListBox", "SingleSelectionFollowsFocus"))
    {
        listBox1.SingleSelectionFollowsFocus = false;
    }
}