Graphics::TranslateTransform 메서드(gdiplusgraphics.h)
Graphics::TranslateTransform 메서드는 이 Graphics 개체의 월드 변환 매트릭스를 자체의 제품 및 변환 행렬로 업데이트합니다.
구문
Status TranslateTransform(
[in] REAL dx,
[in] REAL dy,
[in, optional] MatrixOrder order
);
매개 변수
[in] dx
형식: REAL
번역의 가로 구성 요소를 지정하는 실수입니다.
[in] dy
형식: REAL
번역의 세로 구성 요소를 지정하는 실수입니다.
[in, optional] order
형식: MatrixOrder
선택 사항입니다. 곱하기 순서를 지정하는 MatrixOrder 열거형의 요소입니다. MatrixOrderPrepend 는 변환 행렬이 왼쪽에 있음을 지정하고 MatrixOrderAppend 는 번역 행렬이 오른쪽에 있음을 지정합니다. 기본값은 MatrixOrderPrepend입니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
참고 GDI+는 월드 변환 눈금이 x 또는 y 방향으로 100%(1.0f) 미만인 경우 브러시를 다르게 처리합니다. 월드 변환 눈금이 100%(1.0f) 미만인 경우 TranslateTransform의 오프셋을 월드 변환 배율에 곱해야 합니다.
예제
다음은 Graphics 개체의 월드 변환을 회전으로 설정하는 예제입니다. Graphics::TranslateTransform에 대한 호출은 Graphics 개체의 기존 월드 변환 행렬(회전)을 변환 행렬에 곱합니다. MatrixOrderAppend 인수는 곱하기가 오른쪽의 변환 행렬로 수행되도록 지정합니다. 이 시점에서 Graphics 개체의 월드 변환 매트릭스는 복합 변환을 나타냅니다. 먼저 회전한 다음 변환합니다. DrawEllipse 호출은 회전된 타원과 번역된 타원을 그립니다.
VOID Example_TranslateTransform(HDC hdc)
{
Graphics graphics(hdc);
Pen pen(Color(255, 0, 0, 255));
graphics.RotateTransform(30.0f);
graphics.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);
graphics.DrawEllipse(&pen, 0, 0, 200, 80);
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusgraphics.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |