Класс PhysicalGestureRecognizer

[Некоторые сведения связаны с предварительно выпущенным продуктом, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.]

Выполняет распознавание жестов на входных данных указателя, с выходными данными, возвращаемыми в единицах относительно устройства, а не на пикселях, возвращаемых ЖестомRecognizer. Эти выходные единицы лучше подходят для ввода сенсорной панели, чтобы жесты можно было распознать относительно самой сенсорной панели, а не для отображения.

После отправки указателя на распознаватель становится активным. Он остается активным до тех пор, пока входное взаимодействие не будет завершено — либо путем передачи входных данных для всех контактов, либо принудительного завершения его с помощью CompleteGesture().

Все API-интерфейсы работают одинаково со своими коллегами в GestureRecognizer. Единственное различие заключается в пространстве координат распознаваемых выходных данных, предоставляемых с помощью событий жестов.

Namespace: Windows. Пользовательского интерфейса. Вход

Members

Конструктор

PhysicalGestureRecognizer();

Возвращает новый экземпляр класса среды выполнения PhysicalGestureRecognizer .

Свойства

IsActive

Boolean IsActive { get; }

Возвращает, обрабатывается ли входное взаимодействие.

ЖестыSettings

Windows.UI.Input.GestureSettings GestureSettings;

Возвращает или задает жесты, настроенные для распознавания. PhysicalGestureRecognizer поддерживает следующее подмножество жестов:

  • Коснитесь
  • Hold
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • Масштабирование манипуляций
  • ManipulationMultipleFingerPanning

Входные данные сенсорной панели никогда не распознаются как касание или удержание, так как ввод сенсорной панели получается только в сценариях, где эти жесты больше не могут выполняться.

TapMinContactCount

UInt32 TapMinContactCount;

Возвращает или задает минимальное количество контактов, необходимых для распознавания касания.

TapMaxContactCount

UInt32 TapMaxContactCount;

Возвращает или задает максимальное количество контактов, необходимых для распознавания касания.

HoldMinContactCount

UInt32 HoldMinContactCount;

Возвращает или задает минимальное количество контактов, необходимых для распознавания удержания.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Возвращает или задает максимальное количество контактов, необходимых для распознавания удержания.

HoldRadius

Single HoldRadius;

Возвращает или задает радиус, в пределах которого контакт должен оставаться от исходного места вниз для распознавания касания или удержания.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Возвращает или задает период времени, когда контакт должен оставаться нажатой, прежде чем будет распознано удержание. Если длительность контакта меньше, чем это значение, когда он уходит, и он не путешествовал дальше , чем HoldRadius, то касание распознается.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Возвращает или задает минимальное количество контактов, необходимых для распознавания перевода.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Возвращает или задает максимальное количество контактов, необходимых для распознавания перевода.

Методы

ProcessDownEvent, ProcessMoveEvents, ProcessUpEvent

void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);

Передает указанные входные данные указателя в PhysicalGestureRecognizer для распознавания жестов.

CompleteGesture

void CompleteGesture();

Завершает текущее взаимодействие, чтобы последующие входные данные рассматривались как новый жест. Если в настоящее время выполняется жест, будут активированы события для его завершения.

События

ManipulationStarted

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;

Активируется, когда PhysicalGestureRecognizer начинает распознавание манипуляции.

Манипуляции

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;

Активируется, когда PhysicalGestureRecognizer получает обновленные входные данные во время манипуляции.

МанипуляцияЗавершена

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;

Активируется, когда PhysicalGestureRecognizer завершает распознавание манипуляции.

Нажато

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.TappedEventArgs> Tapped;

Активируется, когда PhysicalGestureRecognizer распознает касание.

Владение

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.HoldingEventArgs> Holding;

Активируется, когда PhysicalGestureRecognizer распознает жест удержания.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 11
Namespace Windows. Пользовательского интерфейса. Вход
API на основе контракта Windows. Foundation.UniversalApiContract (версия 19)
IID IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c6d

См. также

  • Last updated on