InteractionTracker.TryUpdatePosition Método

Definição

Namespace:

Windows.UI.Composition.Interactions

Sobrecargas

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	Tenta atualizar a posição do InteractionTracker usando a opção de fixação especificada.
TryUpdatePosition(Vector3)	Tenta atualizar a posição do InteractionTracker. O método TryUpdatePosition atualiza o local de InteractionTracker para a posição vector3 especificada como um parâmetro. TryUpdatePosition é usado para definir declarativamente a posição do InteractionTracker a qualquer momento (seja no início, de algum evento inserido pelo estado, etc.). TryUpdatePosition pode ser chamado do estado Ocioso, CustomAnimation ou Inércia. Isso moverá a posição de InteractionTracker para a posição definida e entrará no estado ocioso.
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)	Tenta atualizar a posição do InteractionTracker usando a opção de fixação especificada.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Tenta atualizar a posição do InteractionTracker usando a opção de fixação 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

A nova posição para o InteractionTracker.

option

InteractionTrackerClampingOption

Um valor que especifica como os valores são fixados no máximo e no mínimo.

posUpdateOption

InteractionTrackerPositionUpdateOption

Um valor que especifica se uma animação de escala personalizada já em execução deve ter permissão para continuar em execução.

Retornos

Int32

int

Retorna a ID da solicitação. Em transições de estado, a solicitação que causou a alteração no estado será incluída nos args. Essas IDs começarão em 1 e aumentarão com cada chamada try durante o tempo de vida do aplicativo.

Atributos

OverloadAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 2004 (introduzida na 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v10.0)

TryUpdatePosition(Vector3)

Tenta atualizar a posição do InteractionTracker.

O método TryUpdatePosition atualiza o local de InteractionTracker para a posição vector3 especificada como um parâmetro. TryUpdatePosition é usado para definir declarativamente a posição do InteractionTracker a qualquer momento (seja no início, de algum evento inserido pelo estado, etc.). TryUpdatePosition pode ser chamado do estado Ocioso, CustomAnimation ou Inércia. Isso moverá a posição de InteractionTracker para a posição definida e entrará no estado ocioso.

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

A nova posição para o InteractionTracker.

Retornos

Int32

int

Retorna a ID da solicitação. Em transições de estado, a solicitação que causou a alteração no estado será incluída nos args. Essas IDs começarão em 1 e aumentarão com cada chamada try durante o tempo de vida do aplicativo.

Exemplos

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

Comentários

Se InteractionTracker estiver em seu estado de interação (manipulação ativa do usuário) e TryUpdatePosition for chamado, o sistema ignorará essa solicitação – um evento será acionado quando isso ocorrer, que pode ser escutado. Se enviado de um dos outros estados, ouça o evento acionado para IdleStateEntered e marcar a propriedade RequestId que identifica qual solicitação disparou o retorno de chamada. A tabela a seguir resume o comportamento esperado quando esse método é chamado em um estado específico:

Estado Atual	Resultado
Ocioso	Atualizações de propriedade para o valor solicitado, sem alterações de estado
Interação	Solicitação ignorada
Inércia	Atualizações de propriedade para valor solicitado, alterações de estado para Idle
CustomAnimation	Atualizações de propriedade para valor solicitado, alterações de estado para Idle

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Tenta atualizar a posição do InteractionTracker usando a opção de fixação 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

A nova posição para o InteractionTracker.

option

InteractionTrackerClampingOption

Um valor que especifica como os valores são fixados no máximo e no mínimo.

Retornos

Int32

int

Retorna a ID da solicitação. Em transições de estado, a solicitação que causou a alteração no estado será incluída nos args. Essas IDs começarão em 1 e aumentarão com cada chamada try durante o tempo de vida do aplicativo.

Atributos

OverloadAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)