ListBox.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 = listBox.singleSelectionFollowsFocus;
listBox.singleSelectionFollowsFocus = boolean;

Public Property SingleSelectionFollowsFocus As Boolean

<ListBox SingleSelectionFollowsFocus="bool" />

プロパティ値

Boolean

bool

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

注釈

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

既定では、リスト ボックスが 1 つの選択用に構成されている場合、ユーザーがキーボード フォーカスを項目に移動すると、フォーカスのある項目も選択されます。 たとえば、キーボード フォーカスが最初の項目から 2 番目の項目に移動された場合、 SelectedIndex プロパティは 0 から 1 に更新されます。

このプロパティを false に設定すると、ユーザーは項目の選択を行わずにフォーカスを移動できます。 たとえば、選択の変更ごとに UI が大幅に更新される場合は、ユーザーが隣接していないアイテムにフォーカスを移動させ、Enter キーを押して選択内容を更新できます。

バージョンの互換性

SingleSelectionFollowsFocus プロパティは、バージョン 1607 Windows 10より前は使用できません。 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;
    }
}