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 に設定されていない場合、このプロパティは無視されます。

既定では、リスト ボックスが 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;
    }
}