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

아티클
03/14/2023

LinearGradientBrush::GetInterpolationColors 메서드는 현재 이 선형 그라데이션 브러시 및 해당 혼합 위치에 대해 보간되도록 설정된 색을 가져옵니다.

구문

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

매개 변수

[out] presetColors

형식: 색*

색을 받는 배열에 대한 포인터입니다. presetColors 배열에서 지정된 인덱스의 색은 blendPositions 배열에서 동일한 인덱스의 혼합 위치에 해당합니다.

[out] blendPositions

형식: REAL*

혼합 위치를 받는 배열에 대한 포인터입니다. 배열의 각 숫자는 시작 경계와 끝 경계 사이의 거리 백분율을 나타내며 0.0에서 1.0 사이의 범위에 있습니다. 여기서 0.0은 그라데이션의 시작 경계를 나타내고 1.0은 끝 경계를 나타냅니다. 0.0에서 1.0 사이의 혼합 위치는 경계선과 평행한 선을 나타내며, 이는 시작 경계에서 끝 경계까지의 거리의 특정 부분입니다. 예를 들어 혼합 위치 0.7은 시작 경계에서 끝 경계까지의 거리의 70%인 선을 나타냅니다. 색은 경계선과 평행한 선에서 일정합니다.

[in] count

형식: INT

presetColors 배열의 요소 수를 지정하는 정수입니다. blendPositions 배열의 요소 수와 동일합니다. LinearGradientBrush 개체의 LinearGradientBrush::GetInterpolationColors 메서드를 호출하기 전에 동일한 LinearGradientBrush 개체의 LinearGradientBrush::GetInterpolationColorCount 메서드를 호출하여 현재 색 수를 확인합니다. 검색된 혼합 위치의 수는 검색된 색 수와 동일합니다.

반환 값

형식: 상태

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

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

요구 사항


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