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);
}

요구 사항

추가 정보

브러시 및 채워진 도형

색상

선형 그라데이션 만들기

도형에 색 그라데이션 채우기

LinearGradientBrush

LinearGradientBrush::GetBlend

Rect