다음을 통해 공유

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에서 도입되었습니다.)

적용 대상