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

色と共に使用する カラー プロファイル。

color パラメーターで渡されるXPS_COLOR構造体の colorType フィールドの値がXPS_COLOR_TYPE_CONTEXT場合は、カラー プロファイルが必要です。 colorType フィールドの値がXPS_COLOR_TYPE_CONTEXTされていない場合は、このパラメーターを NULL に設定する必要があります。

戻り値

このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメント エラー」を参照してください。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 color は 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