Graphics::TranslateTransform 메서드(gdiplusgraphics.h)

아티클
02/26/2024

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