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" />
Значение свойства
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;
}
}