LinearGradientBrush::GetTransform 메서드(gdiplusbrush.h)

아티클
08/23/2023

LinearGradientBrush::GetTransform 메서드는 이 선형 그라데이션 브러시의 변환 행렬을 가져옵니다.

구문

Status GetTransform(
  [out] Matrix *matrix
);

매개 변수

[out] matrix

형식: Matrix*

변환 행렬을 수신하는 Matrix 개체에 대한 포인터입니다.

반환 값

형식: 상태

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

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

설명

LinearGradientBrush 개체는 모든 아핀 변환을 저장할 수 있는 변환 매트릭스를 유지 관리합니다. 선형 그라데이션 브러시를 사용하여 영역을 채우면 GDI+는 브러시의 변환 행렬에 따라 브러시의 경계선을 변환한 다음 영역을 채웁니다. 변환된 경계는 렌더링 중에만 존재합니다. LinearGradientBrush 개체에 저장된 경계가 변환되지 않습니다.

예제

다음 예제에서는 선형 그라데이션 브러시를 만들고 변환 행렬을 설정합니다. 다음으로, 코드는 브러시의 변환 매트릭스를 가져오고 행렬 요소를 검사하거나 사용합니다.

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

요구 사항


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