Функция SetColorProfileElement

Функция SetColorProfileElement устанавливает данные элемента для тегового элемента профиля.

Синтаксис

Параметры

hProfile

Определяет дескриптор рассматриваемого профиля.

tag

Идентифицирует теговый элемент.

dwOffset

Определяет смещение от первого байта данных тегового элемента, от которого начинается запись.

pcbSize

Указатель на переменную, содержащую число записанных байтов данных. По возвращению, он содержит число фактически записанных байтов.

pBuffer

Указатель на буфер, содержащий записываемые данные для тегового элемента в профиле цвета.

Возвращаемые значения

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE).

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Для дополнительной информации об ошибке, вызовите GetLastError.

Замечания

Если профиль цвета не открыт с правом чтения - записи, эта функция завершается ошибкой.

Если параметр dwOffset выходит за пределы размера, установленного для указанного тегового элемента, эта функция завершается ошибкой.

Если dwOffset + *pcbSize больше, чем размер указанного элемента, то эта функция записывает только столько байтов, сколько может вместится в пределах текущего размера элемента.

Любые существующие данные в указанной части тегового элемента записываются поверх, когда эта функция завершается успешно.

Смотри также

Обзор Основные понятия управления цветом, Функции, используемые ICM