InteractionTracker.TryUpdatePositionBy Método

Definición

Espacio de nombres:

Windows.UI.Composition.Interactions

Sobrecargas

TryUpdatePositionBy(Vector3)

Intenta ajustar la posición de InteractionTracker según la cantidad especificada. El método TryUpdatePositionBy actualiza la ubicación actual de InteractionTracker por el delta Vector3 especificado como parámetro. De forma similar a TryUpdatePosition, TryUpdatePositionBy se usa para mover de forma declarativa InteractionTracker mediante una diferencia definida sin necesidad de una animación o inercia. Se puede llamar a TryUpdatePositionBy desde el estado Inactivo, CustomAnimation o Inercia; si lo hace, moverá la posición de InteractionTracker mediante el delta definido y entrará en estado de inactividad.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Intenta ajustar la posición de InteractionTracker por la cantidad especificada utilizando la opción de fijación especificada.

TryUpdatePositionBy(Vector3)

Intenta ajustar la posición de InteractionTracker según la cantidad especificada.

El método TryUpdatePositionBy actualiza la ubicación actual de InteractionTracker por el delta Vector3 especificado como parámetro. De forma similar a TryUpdatePosition, TryUpdatePositionBy se usa para mover de forma declarativa InteractionTracker mediante una diferencia definida sin necesidad de una animación o inercia. Se puede llamar a TryUpdatePositionBy desde el estado Inactivo, CustomAnimation o Inercia; si lo hace, moverá la posición de InteractionTracker mediante el delta definido y entrará en estado de inactividad.

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

Parámetros

amount

Vector3 Vector3

float3

Valor que se va a agregar a la posición actual.

Devoluciones

Int32

int

Devuelve el identificador de solicitud. En las transiciones de estado, la solicitud que provocó el cambio en estado se incluirá en los argumentos. Estos identificadores comenzarán en 1 y aumentarán con cada llamada try durante la vigencia de la aplicación.

Ejemplos

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

Comentarios

Si InteractionTracker está en su estado de interacción (manipulación activa del usuario) y se llama a TryUpdatePositionBy, el sistema omitirá esta solicitud: se desencadena un evento cuando se produzca esto que se pueda escuchar. Si se envía desde uno de los otros estados, escuche el evento desencadenado para IdleStateEntered y compruebe la propiedad RequestId que identifica qué solicitud desencadenó la devolución de llamada. En la tabla siguiente se resume el comportamiento esperado cuando se llama a este método en un estado determinado:

Estado actual	Resultado
Inactivo	Actualizaciones de propiedades para el valor solicitado, sin cambios de estado
Interacción	Solicitud omitida
Inercia	Actualizaciones de propiedades para el valor solicitado, cambios de estado en Idle
CustomAnimation	Actualizaciones de propiedades para el valor solicitado, cambios de estado en Idle

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Intenta ajustar la posición de InteractionTracker por la cantidad especificada utilizando la opción de fijación especificada.

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

Parámetros

amount

Vector3 Vector3

float3

Valor que se va a agregar a la posición actual.

option

InteractionTrackerClampingOption

Valor que especifica cómo se fijan los valores al máximo y mínimo.

Devoluciones

Int32

int

Devuelve el identificador de solicitud. En las transiciones de estado, la solicitud que provocó el cambio en estado se incluirá en los argumentos. Estos identificadores comenzarán en 1 y aumentarán con cada llamada try durante la vigencia de la aplicación.

Atributos

OverloadAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)