IXpsOMObjectFactory::CreateLinearGradientBrush 메서드(xpsobjectmodel.h)

IXpsOMLinearGradientBrush 인터페이스를 만듭니다.

구문

HRESULT CreateLinearGradientBrush(
  [in]          IXpsOMGradientStop        *gradStop1,
  [in]          IXpsOMGradientStop        *gradStop2,
  [in]          const XPS_POINT           *startPoint,
  [in]          const XPS_POINT           *endPoint,
  [out, retval] IXpsOMLinearGradientBrush **linearGradientBrush
);

매개 변수

[in] gradStop1

그라데이션 벡터의 시작 부분에 있는 그라데이션 속성을 지정하는 IXpsOMGradientStop 인터페이스입니다. 이 매개 변수는 NULL이 아니어야 합니다.

[in] gradStop2

그라데이션 벡터의 끝에 있는 그라데이션 속성을 지정하는 IXpsOMGradientStop 인터페이스입니다. 이 매개 변수는 NULL이 아니어야 합니다.

[in] startPoint

2차원 공간에서 시작점의 좌표를 포함하는 XPS_POINT 구조체입니다.

[in] endPoint

2차원 공간에서 끝점의 좌표를 포함하는 XPS_POINT 구조체입니다.

[out, retval] linearGradientBrush

새 IXpsOMLinearGradientBrush 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

설명

선형 그라데이션의 그라데이션 영역은 시작점과 끝점 사이의 영역이며 그라데이션 경로에 대한 직각으로 양방향으로 확장됩니다. 확산 영역은 그라데이션 영역 외부에 있는 기하 도형의 영역입니다.

그라데이션 중지점은 그라데이션 경로를 따라 특정 위치에서 색을 정의합니다. 그림에서 gradStop1 매개 변수로 지정된 그라데이션 중지점 0은 그라데이션 경로의 시작점에 있으며 gradStop2 매개 변수로 지정된 그라데이션 중지 1은 끝점에 있습니다.

다음 그림과 같이 선형 그라데이션의 시작점과 끝점은 그라데이션 경로의 시작점과 끝점이기도 하며, 이는 해당 점을 연결하는 직선입니다.

IXpsOMLinearGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                startPoint, endPoint;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateLinearGradientBrush (
        gradStop1,
        gradStop2,
        &startPoint,
        &endPoint,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

요구 사항

추가 정보

IXpsOMGradientStop

IXpsOMLinearGradientBrush

IXpsOMObjectFactory

XML Paper Specification

XPS 문서 오류

XPS_POINT