PathGradientBrush::TranslateTransform 메서드(gdipluspath.h)

아티클
08/24/2023

PathGradientBrush::TranslateTransform 메서드는 이 브러시의 현재 변환 매트릭스를 자체의 곱과 번역 행렬로 업데이트합니다.

구문

Status TranslateTransform(
  [in] REAL        dx,
  [in] REAL        dy,
  [in] MatrixOrder order
);

매개 변수

[in] dx

형식: REAL

번역의 가로 구성 요소를 지정하는 실수입니다.

[in] dy

형식: REAL

번역의 세로 구성 요소를 지정하는 실수입니다.

[in] order

형식: MatrixOrder

선택 사항입니다. 곱하기 순서를 지정하는 MatrixOrder 열거형의 요소입니다. MatrixOrderPrepend 는 번역 행렬이 왼쪽에 있음을 지정하고 MatrixOrderAppend 는 번역 행렬이 오른쪽에 있음을 지정합니다. 기본값은 MatrixOrderPrepend입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

단일 3 ×3 행렬은 모든 일련의 아핀 변환을 저장할 수 있습니다. 각각 아핀 변환을 나타내는 3개의 ×3 행렬이 여러 개 있는 경우 이러한 행렬의 곱은 전체 변환 시퀀스를 나타내는 단일 3 ×3 행렬입니다. 해당 제품이 나타내는 변환을 복합 변환이라고 합니다. 예를 들어 행렬 S가 크기 조정을 나타내고 행렬 T가 변환을 나타낸다고 가정합니다. 행렬 M이 제품 ST인 경우 행렬 M은 복합 변환을 나타냅니다. 첫 번째 눈금은 변환합니다.

예제

다음 예제에서는 삼각형 경로를 기반으로 PathGradientBrush 개체를 만듭니다. PathGradientBrush 개체의 PathGradientBrush::ScaleTransform 및 PathGradientBrush::TranslateTransform 메서드에 대한 호출은 복합 변환을 나타내도록 브러시의 변환 행렬 요소를 설정합니다. 첫 번째 눈금, 변환. 이 코드는 경로 그라데이션 브러시를 두 번 사용하여 사각형을 그립니다. 변환이 설정되기 전에 한 번, 변환이 설정된 후 한 번입니다.

VOID Example_TranslateTrans(HDC hdc)
{
   Graphics graphics(hdc);

   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);

   pthGrBrush.ScaleTransform(3.0f, 1.0f);
   pthGrBrush.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);

   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);  
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdipluspath.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll