Поделиться через


Функция 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 Color System (WCS) CAMP, DMP и GMMP; Поскольку элементы профиля неявно связаны с типами тегов ICC и жестко закодированы для них, и существует множество надежных библиотек синтаксического анализа XML.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

См. также раздел