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

Функция 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 for Unicode в Системах Windows 95/98/Me.

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h
Библиотека Gdi32.lib
DLL Gdi32.dll

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