ListViewBase.SingleSelectionFollowsFocus 屬性

定義

命名空間:

Microsoft.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。

備註

如果清單檢視的 SelectionMode 屬性未設定為 Single，則會忽略這個屬性。

根據預設，當清單檢視設定為單一選取專案時，當使用者將鍵盤焦點移至專案時，也會選取焦點專案。 例如，如果鍵盤焦點從第一個專案移到第二個專案， SelectedIndex 屬性就會從 0 更新為 1。

將此屬性設定為 false ，讓使用者不需選取下列專案即可移動焦點。 例如，如果每個選取項目變更造成重要的UI更新，您可能偏好讓使用者將焦點移至非相鄰的專案，然後按Enter鍵來更新選取專案。

版本相容性

在 Windows 10 1607 版之前，無法使用 SingleSelectionFollowsFocus 屬性。 如果您的應用程式在 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;
    }
}