InteractionTracker.TryUpdatePositionBy Método

Definição

Namespace:

Windows.UI.Composition.Interactions

Sobrecargas

TryUpdatePositionBy(Vector3)

Tenta ajustar a posição do InteractionTracker pelo valor especificado. O método TryUpdatePositionBy atualiza o local atual do InteractionTracker pelo delta vector3 especificado como um parâmetro. Da mesma forma que TryUpdatePosition, TryUpdatePositionBy é usado para mover declarativamente o InteractionTracker por um delta definido sem a necessidade de uma animação ou Inércia. TryUpdatePositionBy pode ser chamado do estado Ocioso, CustomAnimation ou Inércia. Isso moverá a posição do InteractionTracker pelo delta definido e entrará no estado ocioso.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Tenta ajustar a posição do InteractionTracker pelo valor especificado usando a opção de fixação especificada.

TryUpdatePositionBy(Vector3)

Tenta ajustar a posição do InteractionTracker pelo valor especificado.

O método TryUpdatePositionBy atualiza o local atual do InteractionTracker pelo delta vector3 especificado como um parâmetro. Da mesma forma que TryUpdatePosition, TryUpdatePositionBy é usado para mover declarativamente o InteractionTracker por um delta definido sem a necessidade de uma animação ou Inércia. TryUpdatePositionBy pode ser chamado do estado Ocioso, CustomAnimation ou Inércia. Isso moverá a posição do InteractionTracker pelo delta definido e entrará no estado ocioso.

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

O valor a ser adicionado à posição atual.

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 argumentos. Essas IDs começarão em 1 e aumentarão a cada chamada try durante o tempo de vida do aplicativo.

Exemplos

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

Comentários

Se InteractionTracker estiver em seu estado de interação (manipulação ativa do usuário) e TryUpdatePositionBy 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 o valor solicitado, estado alterado para Ocioso
CustomAnimation	Atualizações de propriedade para o valor solicitado, estado alterado para Ocioso

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

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

O valor a ser adicionado à posição atual.

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 argumentos. Essas IDs começarão em 1 e aumentarão a 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)