InteractionTracker.TryUpdatePosition Método

Definição

Namespace:

Microsoft.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 doInteractionTracker. 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 de 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 doInteractionTracker .

option

InteractionTrackerClampingOption

Um valor que especifica como os valores são fixados ao máximo e ao 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

TryUpdatePosition(Vector3)

Tenta atualizar a posição doInteractionTracker.

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 de 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 doInteractionTracker .

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 possa ser escutado. Se enviado de um dos outros estados, ouça o evento disparado para IdleStateEntered e verifique 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
Interagindo	Solicitação ignorada
Inércia	Atualizações de propriedade para o valor solicitado, alterações de estado para ocioso
CustomAnimation	Atualizações de propriedade para o valor solicitado, alterações de estado para ocioso

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 doInteractionTracker .

option

InteractionTrackerClampingOption

Um valor que especifica como os valores são fixados ao máximo e ao 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