InteractionTracker.TryUpdatePosition Método

Definición

Espacio de nombres:

Windows.UI.Composition.Interactions

Sobrecargas

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	Intenta actualizar la posición de InteractionTracker mediante la opción de fijación especificada.
TryUpdatePosition(Vector3)	Intenta actualizar la posición de InteractionTracker. El método TryUpdatePosition actualiza la ubicación de InteractionTracker a la posición Vector3 especificada como parámetro. TryUpdatePosition se usa para definir mediante declaración la posición de InteractionTracker en cualquier momento (ya sea al principio, desde algún evento especificado por el estado, etc.). Se puede llamar a TryUpdatePosition desde el estado Idle, CustomAnimation o Inercia. Si lo hace, moverá la posición de InteractionTracker a la posición definida y entrará en el estado inactivo.
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)	Intenta actualizar la posición de InteractionTracker mediante la opción de fijación especificada.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Intenta actualizar la posición de InteractionTracker mediante la opción de fijación especificada.

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

Parámetros

value

Vector3 Vector3

float3

Nueva posición para InteractionTracker.

option

InteractionTrackerClampingOption

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

posUpdateOption

InteractionTrackerPositionUpdateOption

Valor que especifica si se debe permitir que una animación de escala personalizada ya en ejecución siga ejecutándose.

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 se iniciará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 2004 (se introdujo en la versión 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v10.0)

TryUpdatePosition(Vector3)

Intenta actualizar la posición de InteractionTracker.

El método TryUpdatePosition actualiza la ubicación de InteractionTracker a la posición Vector3 especificada como parámetro. TryUpdatePosition se usa para definir mediante declaración la posición de InteractionTracker en cualquier momento (ya sea al principio, desde algún evento especificado por el estado, etc.). Se puede llamar a TryUpdatePosition desde el estado Idle, CustomAnimation o Inercia. Si lo hace, moverá la posición de InteractionTracker a la posición definida y entrará en el estado inactivo.

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

Parámetros

value

Vector3 Vector3

float3

Nueva posición para InteractionTracker.

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 se iniciarán en 1 y aumentarán con cada llamada try durante la vigencia de la aplicación.

Ejemplos

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

Comentarios

Si InteractionTracker se encuentra en su estado de interacción (manipulación activa del usuario) y se llama a TryUpdatePosition, 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 en el valor solicitado, sin cambios de estado
Interacción	Solicitud omitida
Inercia	Actualizaciones de propiedades en el valor solicitado, cambios de estado en Idle
CustomAnimation	Actualizaciones de propiedades en el valor solicitado, cambios de estado en Idle

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Intenta actualizar la posición de InteractionTracker mediante la opción de fijación especificada.

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

Parámetros

value

Vector3 Vector3

float3

Nueva posición para InteractionTracker.

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 se iniciará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)