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.

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