InteractionTracker.TryUpdatePositionBy Метод

Определение

Пространство имен:

Microsoft.UI.Composition.Interactions

Перегрузки

TryUpdatePositionBy(Vector3)

Пытается изменить позицию InteractionTracker на указанную величину. Метод TryUpdatePositionBy обновляет текущее расположение InteractionTracker с помощью дельты Vector3, указанной в качестве параметра. Как и в случае с TryUpdatePosition, TryUpdatePositionBy используется для декларативного перемещения InteractionTracker по определенному разностному значению без необходимости анимации или инерции. TryUpdatePositionBy можно вызвать из состояния Idle, CustomAnimation или Инерция. Это приведет к перемещению позиции InteractionTracker на определенную дельту и перейдет в состояние простоя.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Пытается настроить положение InteractionTracker на указанную величину с помощью указанного параметра закрепления.

TryUpdatePositionBy(Vector3)

Пытается изменить позицию InteractionTracker на указанную величину.

Метод TryUpdatePositionBy обновляет текущее расположение InteractionTracker с помощью дельты Vector3, указанной в качестве параметра. Как и в случае с TryUpdatePosition, TryUpdatePositionBy используется для декларативного перемещения InteractionTracker по определенному разностному значению без необходимости анимации или инерции. TryUpdatePositionBy можно вызвать из состояния Idle, CustomAnimation или Инерция. Это приведет к перемещению позиции InteractionTracker на определенную дельту и перейдет в состояние простоя.

public:
 virtual int TryUpdatePositionBy(float3 amount) = TryUpdatePositionBy;

int TryUpdatePositionBy(float3 const& amount);

public int TryUpdatePositionBy(Vector3 amount);

function tryUpdatePositionBy(amount)

Public Function TryUpdatePositionBy (amount As Vector3) As Integer

Параметры

amount

Vector3 Vector3

float3

Значение, добавляемое к текущей позиции.

Возвращаемое значение

Int32

int

Возвращает идентификатор запроса. При переходе состояния запрос, вызваввший изменение состояния, будет включен в аргументы. Эти идентификаторы начинаются с 1 и увеличиваются с каждым вызовом try в течение времени существования приложения.

Примеры

public void InertiaStateEntered(InteractionTracker sender, 	InteractionTrackerInertiaStateEnteredArgs args)
{
  // For sample purpose, will overwrite Inertia motion definitions by moving InteractionTracker to a specified position based on a delta
  _tracker.TryUpdatePositionBy(new Vector3(50f));}
}

Комментарии

Если InteractionTracker находится в состоянии взаимодействия (пользователь активно управляет) и вызывается TryUpdatePositionBy, система проигнорирует этот запрос . При этом возникает событие, которое можно прослушивать. При отправке из одного из других состояний прослушайте событие IdleStateEntered и проверка свойство RequestId, определяющее, какой запрос вызвал обратный вызов. В таблице ниже приведена сводка ожидаемого поведения при вызове этого метода в определенном состоянии:

Текущее состояние	Результат
Бездействие	Обновление свойства до запрошенного значения, без изменений состояния
Взаимодействие	Запрос игнорируется
Инерция	Обновление свойства на запрошенное значение, изменение состояния на Бездейству
CustomAnimation	Обновление свойства на запрошенное значение, изменение состояния на Бездейству

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Пытается настроить положение InteractionTracker на указанную величину с помощью указанного параметра закрепления.

public:
 virtual int TryUpdatePositionBy(float3 amount, InteractionTrackerClampingOption option) = TryUpdatePositionBy;

/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
int TryUpdatePositionBy(float3 const& amount, InteractionTrackerClampingOption const& option);

[Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
public int TryUpdatePositionBy(Vector3 amount, InteractionTrackerClampingOption option);

function tryUpdatePositionBy(amount, option)

Public Function TryUpdatePositionBy (amount As Vector3, option As InteractionTrackerClampingOption) As Integer

Параметры

amount

Vector3 Vector3

float3

Значение, добавляемое к текущей позиции.

option

InteractionTrackerClampingOption

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

Возвращаемое значение

Int32

int

Возвращает идентификатор запроса. При переходе состояния запрос, вызваввший изменение состояния, будет включен в аргументы. Эти идентификаторы начинаются с 1 и увеличиваются с каждым вызовом try в течение времени существования приложения.

Атрибуты

OverloadAttribute