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

Функция SetICMProfileA (wingdi.h)

  • Статья

Функция setICMProfile задает указанный профиль цвета в качестве выходного профиля для указанного контекста устройства (DC).

Синтаксис

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Параметры

hdc

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

lpFileName

Указывает имя пути для заданного профиля цвета.

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

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

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

Замечания

SetICMProfile связывает цветной профиль с контекстом устройства. Он становится выходным профилем для этого контекста устройства. Профиль цвета не должен быть связан с каким-либо конкретным устройством. Можно также использовать независимые от устройства профили, такие как sRGB. Если цветной профиль не связан с аппаратным устройством, он будет возвращен GetICMProfile, но не EnumICMProfiles.

Обратите внимание, что в Windows 95 или более поздней версии драйвер устройства PostScript для принтеров предполагает цветовую модель CMYK. Поэтому все принтеры PostScript должны использовать цветной профиль CMYK. Windows 2000 не имеет этого ограничения.

SetICMProfile поддерживает только профили RGB в совместимых контроллерах домена.

Windows 95/98/Me: SetICMProfileW поддерживается Microsoft Layer для Юникода. Для этого необходимо добавить в приложение определенные файлы, как описано в Microsoft Layer для Юникода в Windows 95/98/Me Systems.

Заметка

Заголовок wingdi.h определяет SetICMProfile в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка wingdi.h
библиотеки Gdi32.lib
DLL Gdi32.dll

См. также