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


InteractionTracker.TryUpdatePositionBy Метод

Определение

Перегрузки

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 в течение жизненного цикла приложения.

Атрибуты

Требования к Windows

Семейство устройств
Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v7.0)

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