IDirectManipulationViewport::SyncDisplayTransform 메서드(directmanipulation.h)

뷰포트에 대한 표시 변환을 지정하고 출력 변환을 디스플레이 변환의 새 값과 동기화합니다.

구문

HRESULT SyncDisplayTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

[in] matrix

행 단위로 구성된 변환 행렬: _11, _12, _21, _22, _31, _32.

[in] pointCount

변환 행렬의 크기입니다. 3x2 행렬은 모든 직접 조작 변환에 사용되므로 이 값은 항상 6입니다.

메서드가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

애플리케이션이 작성기 외부의 콘텐츠(뷰포트 변환에서 완전히 캡처되지 않은 콘텐츠)의 특수 출력 처리를 수행하는 경우 이 메서드를 호출하여 특수 처리에 대한 표시 변환을 지정해야 합니다.

표시 변환은 조작 업데이트가 출력 변환에 적용되는 방식에 영향을 줍니다. 예를 들어 디스플레이 변환이 배율 3배로 설정된 경우 이동하면 콘텐츠가 원래 거리의 3배로 이동합니다.

이 메서드를 사용하여 디스플레이 변환을 변경하면 출력 변환이 표시 변환의 새 값과 동기화됩니다.

뷰포트 상태 DIRECTMANIPULATION_RUNNING 또는DIRECTMANIPULATION_INERTIA 경우 이 메서드를 호출할 수 없습니다.