_IManipulationEvents::ManipulationDelta 메서드(manipulations.h)

아티클
03/05/2024

조작된 개체가 변경될 때 발생하는 이벤트를 처리합니다.

구문

HRESULT ManipulationDelta(
  [in] FLOAT x,
  [in] FLOAT y,
  [in] FLOAT translationDeltaX,
  [in] FLOAT translationDeltaY,
  [in] FLOAT scaleDelta,
  [in] FLOAT expansionDelta,
  [in] FLOAT rotationDelta,
  [in] FLOAT cumulativeTranslationX,
  [in] FLOAT cumulativeTranslationY,
  [in] FLOAT cumulativeScale,
  [in] FLOAT cumulativeExpansion,
  [in] FLOAT cumulativeRotation
);

매개 변수

[in] x

사용자 정의 좌표의 원본 x 좌표입니다.

[in] y

사용자 정의 좌표의 원본 y 좌표입니다.

[in] translationDeltaX

마지막 이벤트 이후 사용자 정의 좌표의 x축에 대한 변환이 변경됩니다.

[in] translationDeltaY

마지막 이벤트 이후 사용자 정의 좌표의 y축에 대한 변환이 변경됩니다.

[in] scaleDelta

이전 이벤트 이후의 배율 변경은 이전 눈금의 백분율입니다.

[in] expansionDelta

사용자 정의 좌표에서 이전 이벤트 이후의 확장 변경.

[in] rotationDelta

라디안의 이전 이벤트 이후 회전이 변경됩니다.

[in] cumulativeTranslationX

사용자 정의 좌표에서 조작이 시작된 이후 x축에 대한 변환입니다.

[in] cumulativeTranslationY

사용자 정의 좌표에서 조작이 시작된 이후의 y축에 대한 변환입니다.

[in] cumulativeScale

원래 크기의 백분율로 조작이 시작된 이후의 크기 변경입니다.

[in] cumulativeExpansion

사용자 정의 좌표에서 조작이 시작된 이후 확장이 변경됩니다.

[in] cumulativeRotation

라디안에서 조작이 시작된 후 회전이 변경됩니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패하면 HRESULT 오류 코드를 반환합니다.

설명

조작 이벤트는 IInertiaProcessor 및 IManipulationProcessor 인터페이스 모두에 대해 생성됩니다. ProcessMove 호출에서 TOUCHINPUT 구조체의 값을 사용하는 경우 좌표는 수백 픽셀로 표시됩니다.

참고 관성을 사용하는 경우 IInertiaProcessor::Complete 를 호출하면 현재 조작을 강제로 추정하여 큰 델타가 ManipulationCompleted 이벤트에 전달될 수 있습니다. 이 문제를 해결하려면 델타 이벤트 외에도 완료된 이벤트에 대한 업데이트를 수행합니다.

예제

다음 코드는 ManipulationDelta 메서드의 구현을 보여줍니다.

HRESULT STDMETHODCALLTYPE CManipulationEventSink::ManipulationDelta( 
    /* [in] */ FLOAT x,
    /* [in] */ FLOAT y,
    /* [in] */ FLOAT translationDeltaX,
    /* [in] */ FLOAT translationDeltaY,
    /* [in] */ FLOAT scaleDelta,
    /* [in] */ FLOAT expansionDelta,
    /* [in] */ FLOAT rotationDelta,
    /* [in] */ FLOAT cumulativeTranslationX,
    /* [in] */ FLOAT cumulativeTranslationY,
    /* [in] */ FLOAT cumulativeScale,
    /* [in] */ FLOAT cumulativeExpansion,
    /* [in] */ FLOAT cumulativeRotation)
{
    m_cDeltaEventCount ++;

    // Place your code handler here to do any operations based on the manipulation.

    return S_OK;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	manipulations.h(Manipulations.h 포함)