Функция SetColorProfileElement

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

Синтаксис

BOOL WINAPI SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE tag,
  DWORD dwOffset, 
  PDWORD pcbSize,
  PVOID pBuffer
);

Параметры

hProfile

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

tag

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

dwOffset

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

pcbSize

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

pBuffer

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

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

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

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

Замечания

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

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

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

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

Смотри также

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

Размещение и совместимость SetColorProfileElement

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Нет
е Windows Me Да
н Windows 98 Да
т Windows 95 Нет
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Нет
в    
е    
р    
Используемая библиотека Mscms.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Icm.h
 - включено в -
 Unicode Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz