LinearGradientBrush::SetBlend 메서드(gdiplusbrush.h)
LinearGradientBrush::SetBlend 메서드는 이 선형 그라데이션 브러시의 혼합 요소와 혼합 위치를 설정하여 사용자 지정 혼합을 만듭니다.
구문
Status SetBlend(
[in] const REAL *blendFactors,
[in] const REAL *blendPositions,
[in] INT count
);
매개 변수
[in] blendFactors
형식: const REAL*
혼합 요소를 지정하는 실수 배열에 대한 포인터입니다. 배열의 각 숫자는 끝 색의 백분율을 지정하며 0.0에서 1.0까지의 범위에 있어야 합니다.
[in] blendPositions
형식: const REAL*
혼합 위치를 지정하는 실수 배열에 대한 포인터입니다. 배열의 각 숫자는 시작 경계와 끝 경계 사이의 거리 백분율을 나타내며 0.0에서 1.0 사이의 범위에 있습니다. 여기서 0.0은 그라데이션의 시작 경계를 나타내고 1.0은 끝 경계를 나타냅니다. 두 개 이상의 위치가 지정되어야 합니다. 첫 번째 위치는 항상 0.0f이고 마지막 위치는 항상 1.0f입니다. 그렇지 않으면 동작이 정의되지 않습니다. 0.0에서 1.0 사이의 혼합 위치는 경계선과 평행한 선을 나타내며, 이는 시작 경계에서 끝 경계까지의 거리의 특정 부분입니다. 예를 들어 혼합 위치 0.7은 시작 경계에서 끝 경계까지의 거리의 70%인 선을 나타냅니다. 색은 경계선과 평행한 선에서 상수입니다.
[in] count
형식: INT
blendFactors 배열의 요소 수를 지정하는 정수입니다. blendPositions 배열의 요소 수와 동일합니다. 지정된 배열 인덱스의 혼합 요소는 동일한 배열 인덱스의 혼합 위치에 해당합니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
LinearGradientBrush 개체에는 두 개의 경계가 있습니다. 선형 그라데이션 브러시로 영역을 채우면 시작 경계에서 끝 경계로 이동하면 색이 점차 바뀝니다. 기본적으로 색은 거리와 선형적으로 관련되지만 LinearGradientBrush::SetBlend 메서드를 호출하여 색과 거리 간의 관계를 사용자 지정할 수 있습니다.
예제
다음 예제에서는 선형 그라데이션 브러시를 만들고, 사용자 지정 혼합을 설정하고, 브러시를 사용하여 사각형을 채웁니다.
VOID Example_SetBlend(HDC hdc)
{
Graphics myGraphics(hdc);
REAL factors[4] = {0.0f, 0.4f, 0.6f, 1.0f};
REAL positions[4] = {0.0f, 0.2f, 0.8f, 1.0f};
Rect rect(0, 0, 100, 50);
LinearGradientBrush linGrBrush(
rect,
Color(255, 255, 0, 0), // red
Color(255, 0, 0, 255), // blue
LinearGradientModeHorizontal);
linGrBrush.SetBlend(factors, positions, 4);
myGraphics.FillRectangle(&linGrBrush, rect);
}
요구 사항
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusbrush.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |