InteractionTracker.TryUpdatePosition Метод

Определение

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

Windows.UI.Composition.Interactions

Перегрузки

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

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

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

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption) = TryUpdatePosition;

/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option, InteractionTrackerPositionUpdateOption const& posUpdateOption);

[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption);

function tryUpdatePosition(value, option, posUpdateOption)

Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption, posUpdateOption As InteractionTrackerPositionUpdateOption) As Integer

Параметры

value

Vector3 Vector3

float3

Новая позиция для InteractionTracker.

option

InteractionTrackerClampingOption

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

posUpdateOption

InteractionTrackerPositionUpdateOption

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

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

Int32

int

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

Атрибуты

OverloadAttribute

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

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

TryUpdatePosition(Vector3)

Пытается обновить положение InteractionTracker.

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

public:
 virtual int TryUpdatePosition(float3 value) = TryUpdatePosition;

int TryUpdatePosition(float3 const& value);

public int TryUpdatePosition(Vector3 value);

function tryUpdatePosition(value)

Public Function TryUpdatePosition (value As Vector3) As Integer

Параметры

value

Vector3 Vector3

float3

Новая позиция для InteractionTracker.

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

Int32

int

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

Примеры

void SetupInteractionTracker()
{
  // Setup InteractionTracker
  _tracker = InteractionTracker.Create(_compositor);
  _interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  _interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(_interactionSource);
  _tracker.PositionInertiaDecayRate = new Vector3(0.95f);

  // Update the position of InteractionTracker, so doesn’t start at (0,0)
  _tracker.TryUpdatePosition(new Vector3(50f));
}

Комментарии

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

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

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

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

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option) = TryUpdatePosition;

/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option);

[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option);

function tryUpdatePosition(value, option)

Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption) As Integer

Параметры

value

Vector3 Vector3

float3

Новая позиция для InteractionTracker.

option

InteractionTrackerClampingOption

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

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

Int32

int

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

Атрибуты

OverloadAttribute

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

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