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 , чтобы пользователь переместил фокус без выбора элемента. Например, если каждое изменение выбора приводит к значительным обновлениям пользовательского интерфейса, вы можете разрешить пользователю переместить фокус на несмежный элемент и нажать клавишу ВВОД, чтобы обновить выделение.

Совместимость версий

Свойство 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;
    }
}