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

뷰포트 좌표계에서 창 클라이언트 좌표계로 변환을 지정합니다.

구문

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

매개 변수

[in] matrix

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

[in] pointCount

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

반환 값

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

설명

이 함수를 호출하여 화면에서 뷰포트 위치, 크기 조정 및 방향을 지정합니다. 뷰포트 위치, 크기 조정, 방향 및 크기는 뷰포트 변환 및 뷰포트 사각형에 의해 고유하게 결정됩니다. 애플리케이션은 이 메서드를 사용하여 뷰포트 변환을 지정하고 SetViewportRect를 사용하여 뷰포트 사각형을 지정할 수 있습니다.

뷰포트 사각형(사용자에게 표시되는 콘텐츠 내의 사각형 영역)은 뷰포트 좌표에 지정됩니다. 뷰포트 사각형 왼쪽 위 점이 (0,0)이면 뷰포트 사각형이 뷰포트 좌표계 원점에 정확히 배치됩니다. 뷰포트 좌표계 원점의 뷰포트 오프셋은 다음 두 가지 방법으로 지정할 수 있습니다.

• 뷰포트 사각형을 통해 왼쪽 위 점
• 뷰포트 변환 변환 구성 요소를 통해(_31, _32)

뷰포트 변환은 뷰포트 좌표계에서 창 클라이언트 좌표계로 변환됩니다. 직접 조작 은 창 RTL 속성을 무시하므로 클라이언트 영역 원본은 항상 왼쪽 위 지점입니다. 변환은 다음 순서로 적용됩니다.

1. 뷰포트 사각형 오프셋
2. 뷰포트 변환(뷰포트에서 클라이언트 좌표계로)
3. 클라이언트에서 화면 매핑(클라이언트에서 화면 좌표계로)

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	directmanipulation.h

추가 정보

IDirectManipulationViewport