ListViewBase.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 = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<listViewBase 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 类在设置此属性之前检查此属性是否存在。

<ListView x:Name="listView1" Loaded="ListView_Loaded"/>

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