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 鍵來更新選取專案。

版本相容性

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