setColorProfileElementSize 函数 (icm.h)

设置 ICC 颜色配置文件中标记的元素的大小。

语法

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

参数

hProfile

指定有问题的 ICC 颜色配置文件的句柄。

tagType

标识标记的元素。

pcbElement

指定要将标记元素设置为的大小。 如果 cbSize 为零，则此函数将删除指定的标记元素。 如果标记是引用，则仅删除标记表条目，而不删除数据。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

如果 hProfile 不是有效的 ICC 配置文件，则此函数将失败。

若要在颜色配置文件中创建新的标记元素，请使用 SetColorProfileElementSize 设置大小，然后使用 SetColorProfileElement 设置元素值。

如果指定的标记已存在于配置文件中， 则 SetColorProfileElementSize 会更改元素的大小，方法是截断元素或在末尾添加零（如情况所示）。

如果指定的标记已存在，并且是对另一个标记的引用， 则 SetColorProfileElementSize 会为不共享的标记创建一个新的数据区域。

此函数不支持 Windows 颜色系统 (WCS) 配置文件 CAMP、DMP 和 GMMP;因为配置文件元素与 ICC 标记类型隐式关联并硬编码，并且存在许多可靠的 XML 分析库。

要求

另请参阅

• 基本颜色管理概念
• 函数
• SetColorProfileElement