다음을 통해 공유

IXpsOMGradientStop::SetColor 메서드(xpsobjectmodel.h)

  • 아티클

그라데이션 중지점의 색 값 및 색 프로필을 설정합니다.

구문

HRESULT SetColor(
  [in] const XPS_COLOR            *color,
  [in] IXpsOMColorProfileResource *colorProfile
);

매개 변수

[in] color

그라데이션 중지점에서 설정할 색 값입니다.

이 매개 변수에 전달되는 XPS_COLOR 구조체의 colorType 필드 값이 XPS_COLOR_TYPE_CONTEXT 경우 colorProfile 매개 변수에 유효한 색 프로필을 제공해야 합니다.

[in] colorProfile

색과 함께 사용할 색 프로필입니다.

색 매개 변수에 전달된 XPS_COLOR 구조체의 colorType 필드 값이 XPS_COLOR_TYPE_CONTEXT경우 색 프로필이 필요합니다. colorType 필드의 값이 XPS_COLOR_TYPE_CONTEXT 않으면 이 매개 변수를 NULL로 설정해야 합니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_POINTER
 색 이 NULL입니다.
XPS_E_MISSING_COLORPROFILE
 colorProfile 은 색 프로필이 필요한 경우 NULL 입니다. 색 유형이 XPS_COLOR_TYPE_CONTEXT 경우 색 프로필이 필요합니다.
XPS_E_NO_CUSTOM_OBJECTS
 colorProfile 은 인식된 인터페이스 구현을 가리키지 않습니다. XPS 문서 API 인터페이스의 사용자 지정 구현은 지원되지 않습니다.
XPS_E_UNEXPECTED_COLORPROFILE
 colorProfile 에는 색 프로필이 예상되지 않을 때 포함되었습니다. 색 프로필은 색 유형이 XPS_COLOR_TYPE_CONTEXT 경우에만 허용됩니다.

설명

색 프로필은 색 유형이 XPS_COLOR_TYPE_CONTEXT 경우에만 필요합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 xpsobjectmodel.h

추가 정보

IXpsOMColorProfileResource

IXpsOMGradientStop

XML Paper Specification

XPS 문서 오류

XPS_COLOR