Control.RequiresPointer Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, поддерживает ли элемент пользовательского интерфейса режим мыши, который эмулирует взаимодействие с указателем с устройствами ввода без указателя, такими как игровая панель или пульт дистанционного управления.
public:
property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };RequiresPointer RequiresPointer();
void RequiresPointer(RequiresPointer value);public RequiresPointer RequiresPointer { get; set; }var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;Public Property RequiresPointer As RequiresPointer<control RequiresPointer="requiresPointerMemberName"/>
Значение свойства
Режим эмуляции указателя. Значение по умолчанию — Никогда.
Требования к Windows
| Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
Комментарии
Для устройств ввода без указателя фокус перемещается между элементами управления с помощью различных методов, таких как клавиши TAB и клавиши со стрелками на клавиатуре, направляющие (D-pad) на пульте дистанционного управления или палки большого пальца на игровом контроллере. Для некоторых пользовательских возможностей, таких как карты и поверхности рисования, невозможно или нецелесообразно использовать навигацию по фокусу XY. RequiresPointer позволяет приложению обеспечить более похожий на указатель интерфейс взаимодействия с помощью курсора, который можно свободно перемещать с помощью игровых устройств ввода.
RequiresPointer поддерживается только в семействе устройств Xbox и только при использовании игровой панели или пульта дистанционного управления. В противном случае свойство игнорируется.
RequiresPointerMode задает режим мыши на уровне приложения.
Дополнительные сведения см. в разделе Режим мыши статьи Проектирование для Xbox и телевизора.
Совместимость версий
Свойство RequiresPointer недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.
Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не устанавливайте это свойство в XAML и не используйте его без выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого свойства перед его настройкой.
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}