InteractionTracker.TryUpdatePosition 메서드

정의

네임스페이스:

Windows.UI.Composition.Interactions

오버로드

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 업데이트하려고 시도합니다.
TryUpdatePosition(Vector3)	InteractionTracker의 위치를 업데이트하려고 시도합니다. TryUpdatePosition 메서드는 InteractionTracker 의 위치를 매개 변수로 지정된 Vector3 위치로 업데이트합니다. TryUpdatePosition은 언제든지 InteractionTracker 의 위치를 선언적으로 정의하는 데 사용됩니다(시작 시, 일부 상태 입력 이벤트 등). TryUpdatePosition은 유휴 상태, CustomAnimation 또는 관성 상태에서 호출할 수 있습니다. 이렇게 하면 InteractionTracker 의 위치가 정의된 위치로 이동하고 유휴 상태가 됩니다.
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)	지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 업데이트하려고 시도합니다.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 업데이트하려고 시도합니다.

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

매개 변수

value

Vector3 Vector3

float3

InteractionTracker의 새 위치입니다.

option

InteractionTrackerClampingOption

값이 최댓값과 최소값으로 고정되는 방식을 지정하는 값입니다.

posUpdateOption

InteractionTrackerPositionUpdateOption

이미 실행 중인 사용자 지정 크기 조정 애니메이션을 계속 실행할 수 있는지 여부를 지정하는 값입니다.

반환

Int32

int

요청 ID를 반환합니다. 상태 전환 시 상태 변경을 발생시킨 요청이 인수에 포함됩니다. 이러한 ID는 1에서 시작하여 애플리케이션 수명 동안 각 try 호출에 따라 증가합니다.

특성

OverloadAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 2004 (10.0.19041.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v10.0에서 도입되었습니다.)

TryUpdatePosition(Vector3)

InteractionTracker의 위치를 업데이트하려고 시도합니다.

TryUpdatePosition 메서드는 InteractionTracker 의 위치를 매개 변수로 지정된 Vector3 위치로 업데이트합니다. TryUpdatePosition은 언제든지 InteractionTracker 의 위치를 선언적으로 정의하는 데 사용됩니다(시작 시, 일부 상태 입력 이벤트 등). TryUpdatePosition은 유휴 상태, CustomAnimation 또는 관성 상태에서 호출할 수 있습니다. 이렇게 하면 InteractionTracker 의 위치가 정의된 위치로 이동하고 유휴 상태가 됩니다.

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

매개 변수

value

Vector3 Vector3

float3

InteractionTracker의 새 위치입니다.

반환

Int32

int

요청 ID를 반환합니다. 상태 전환 시 상태 변경을 발생시킨 요청이 인수에 포함됩니다. 이러한 ID는 1에서 시작하여 애플리케이션 수명 동안 각 try 호출에 따라 증가합니다.

예제

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

설명

InteractionTracker가 상호 작용 상태이고(사용자가 적극적으로 조작하고 있음) TryUpdatePosition이 호출되면 시스템에서 이 요청을 무시합니다. 이 요청이 발생하면 수신 대기할 수 있는 이벤트가 발생합니다. 다른 상태 중 하나에서 전송된 경우 IdleStateEntered에 대해 발생한 이벤트를 수신 대기하고 콜백을 트리거한 요청을 식별하는 RequestId 속성을 검사. 아래 표에는 이 메서드가 특정 상태에서 호출될 때 예상되는 동작이 요약되어 있습니다.

현재 상태	결과
유휴 상태	요청된 값으로 속성 업데이트, 상태 변경 없음
상호 작용 중	요청이 무시됨
관성	요청된 값으로 속성 업데이트, 유휴 상태 변경
CustomAnimation	요청된 값으로 속성 업데이트, 유휴 상태 변경

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 업데이트하려고 시도합니다.

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

매개 변수

value

Vector3 Vector3

float3

InteractionTracker의 새 위치입니다.

option

InteractionTrackerClampingOption

값이 최댓값과 최소값으로 고정되는 방식을 지정하는 값입니다.

반환

Int32

int

요청 ID를 반환합니다. 상태 전환 시 상태 변경을 발생시킨 요청이 인수에 포함됩니다. 이러한 ID는 1에서 시작하여 애플리케이션 수명 동안 각 try 호출에 따라 증가합니다.

특성

OverloadAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)