ID2D1GradientStopCollection 인터페이스(d2d1.h)

선형 및 방사형 그라데이션 브러시에 대한 D2D1_GRADIENT_STOP 개체의 컬렉션을 나타냅니다.

상속

ID2D1GradientStopCollection 인터페이스는 ID2D1Resource에서 상속됩니다. ID2D1GradientStopCollection 에는 다음과 같은 유형의 멤버도 있습니다.

• 메서드

메서드

ID2D1GradientStopCollection 인터페이스에는 이러한 메서드가 있습니다.

ID2D1GradientStopCollection::GetColorInterpolationGamma 그라데이션 중지점이 보간되는 감마 공간을 나타냅니다.
ID2D1GradientStopCollection::GetExtendMode 정규화된 그라데이션 범위를 벗어난 그라데이션의 동작을 나타냅니다.
ID2D1GradientStopCollection::GetGradientStopCount 컬렉션의 그라데이션 중지점 수를 검색합니다.
ID2D1GradientStopCollection::GetGradientStops 컬렉션의 그라데이션 중지를 D2D1_GRADIENT_STOP 구조체의 배열로 복사합니다.

설명

ID2D1GradientStopCollection 개체 만들기

ID2D1GradientStopCollection을 만들려면 ID2D1RenderTarget::CreateGradientStopCollection 메서드를 사용합니다.

그라데이션 중지 컬렉션은 디바이스 종속 리소스입니다. 애플리케이션은 그라데이션 중지 컬렉션이 사용될 렌더링 대상을 초기화한 후 그라데이션 중지 컬렉션을 만들고 렌더링 대상을 다시 만들어야 할 때마다 그라데이션 중지 컬렉션을 다시 만들어야 합니다. (리소스에 대한 자세한 내용은 리소스 개요를 참조하세요.)

예제

다음 예제에서는 그라데이션 중지점 배열을 만든 다음, 이를 사용하여 ID2D1GradientStopCollection을 만듭니다.

// Create an array of gradient stops to put in the gradient stop
// collection that will be used in the gradient brush.
ID2D1GradientStopCollection *pGradientStops = NULL;

D2D1_GRADIENT_STOP gradientStops[2];
gradientStops[0].color = D2D1::ColorF(D2D1::ColorF::Yellow, 1);
gradientStops[0].position = 0.0f;
gradientStops[1].color = D2D1::ColorF(D2D1::ColorF::ForestGreen, 1);
gradientStops[1].position = 1.0f;
// Create the ID2D1GradientStopCollection from a previously
// declared array of D2D1_GRADIENT_STOP structs.
hr = m_pRenderTarget->CreateGradientStopCollection(
    gradientStops,
    2,
    D2D1_GAMMA_2_2,
    D2D1_EXTEND_MODE_CLAMP,
    &pGradientStops
    );

다음 코드 예제에서는 ID2D1GradientStopCollection 을 사용하여 ID2D1LinearGradientBrush를 만듭니다.

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	d2d1.h

추가 정보

ID2D1Resource