Поделиться через


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;
}

Применяется к

См. также раздел