InteractionTracker.TryUpdatePositionBy 메서드

정의

네임스페이스:

Windows.UI.Composition.Interactions

오버로드

TryUpdatePositionBy(Vector3)	InteractionTracker의 위치를 지정된 양만큼 조정하려고 시도합니다. TryUpdatePositionBy 메서드는 매개 변수로 지정된 Vector3 델타에 의해 InteractionTracker 의 현재 위치를 업데이트합니다. TryUpdatePosition과 마찬가지로 TryUpdatePositionBy는 애니메이션이나 관성 없이 정의된 델타로 InteractionTracker를 선언적으로 이동하는 데 사용됩니다. TryUpdatePositionBy는 유휴 상태, CustomAnimation 또는 관성 상태에서 호출할 수 있습니다. 이렇게 하면 InteractionTracker 의 위치가 정의된 델타로 이동하고 유휴 상태가 됩니다.
TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)	지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 지정된 양만큼 조정하려고 시도합니다.

TryUpdatePositionBy(Vector3)

InteractionTracker의 위치를 지정된 양만큼 조정하려고 시도합니다.

TryUpdatePositionBy 메서드는 매개 변수로 지정된 Vector3 델타에 의해 InteractionTracker 의 현재 위치를 업데이트합니다. TryUpdatePosition과 마찬가지로 TryUpdatePositionBy는 애니메이션이나 관성 없이 정의된 델타로 InteractionTracker를 선언적으로 이동하는 데 사용됩니다. TryUpdatePositionBy는 유휴 상태, CustomAnimation 또는 관성 상태에서 호출할 수 있습니다. 이렇게 하면 InteractionTracker 의 위치가 정의된 델타로 이동하고 유휴 상태가 됩니다.

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

매개 변수

amount

Vector3 Vector3

float3

현재 위치에 추가할 값입니다.

반환

Int32

int

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

예제

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

설명

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

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

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

지정된 클램핑 옵션을 사용하여 InteractionTracker 의 위치를 지정된 양만큼 조정하려고 시도합니다.

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

매개 변수

amount

Vector3 Vector3

float3

현재 위치에 추가할 값입니다.

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