Compartilhar via


InteractionTracker.TryUpdatePosition Método

Definição

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

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)

Aplica-se a

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 AtualResultado
OciosoAtualizações de propriedade para o valor solicitado, sem alterações de estado
InteraçãoSolicitação ignorada
InérciaAtualizações de propriedade para valor solicitado, alterações de estado para Idle
CustomAnimationAtualizações de propriedade para valor solicitado, alterações de estado para Idle

Aplica-se a

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

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)

Aplica-se a