SetColorProfileElementSize 関数 (icm.h)

ICC カラープロファイルのタグ付けされた要素のサイズを設定します。

構文

BOOL SetColorProfileElementSize(
  HPROFILE hProfile,
  TAGTYPE  tagType,
  DWORD    pcbElement
);

hProfile

問題の ICC カラープロファイルへのハンドルを指定します。

tagType

タグ付けされた要素を識別します。

pcbElement

タグ付けされた要素を設定するサイズを指定します。 cbSize が 0 の場合、この関数は指定されたタグ付き要素を削除します。タグが参照の場合、タグテーブルエントリのみが削除され、データは削除されません。

この関数が成功した場合、戻り値は TRUE になります。

この関数が失敗した場合、戻り値は FALSE になります。拡張エラー情報については、 GetLastError を呼び出します。

hProfile が有効な ICC プロファイルでない場合、この関数は失敗します。

カラープロファイルにタグ付けされた新しい要素を作成するには、 SetColorProfileElementSize を使用してサイズを設定し、 SetColorProfileElement を使用して要素の値を設定します。

指定したタグが既にプロファイルに存在する場合、 SetColorProfileElementSize は要素を切り捨てるか、末尾にゼロを追加することで要素のサイズを変更します。

指定したタグが既に存在し、別のタグへの参照である場合、 SetColorProfileElementSize は、共有されていないタグの新しいデータ領域を作成します。

この関数は、Windows カラーシステム (WCS) プロファイル CAMP、DMP、および GMMP をサポートしていません。プロファイル要素は、ICC タグ型に暗黙的に関連付けられてハードコーディングされ、堅牢な XML 解析ライブラリが多数存在するためです。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	icm.h
Library	Mscms.lib
[DLL]	Mscms.dll