ListBox.SingleSelectionFollowsFocus プロパティ

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" />

プロパティ値

キーボード フォーカスが変更されたときに項目の選択が変更された場合は true。それ以外の場合は false。 既定値は trueです。

注釈

リスト ボックスの SelectionMode プロパティが Single に設定されていない場合、このプロパティは無視されます。

既定では、リスト ボックスが 1 つの選択用に構成されている場合、ユーザーがキーボード フォーカスを項目に移動すると、フォーカスされた項目も選択されます。 たとえば、キーボード フォーカスが最初の項目から 2 番目の項目に移動された場合、 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;
    }
}