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

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

  • Статья

Функция ColorMatchToTarget позволяет просматривать цвета, которые будут отображаться на целевом устройстве.

Синтаксис

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Параметры

hdc

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

hdcTarget

Указывает контекст целевого устройства, как правило, принтера.

action

Константы, которые могут иметь одно из следующих значений.

 

Значение Значение
CS_ENABLE
 Сопоставьте цвета с цветовой гаммой целевого устройства. Это позволяет выполнять проверку цвета. Все последующие команды рисования в контроллере домена будут отображать цвета, как они будут отображаться на целевом устройстве.
CS_DISABLE
 Отключение проверки правописания цвета.
CS_DELETE_TRANSFORM
 Если для целевого профиля включено управление цветом, отключите его и удалите объединенное преобразование.

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

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

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

Комментарии

ColorMatchToTarget можно использовать для проверки цветов устройства вывода цветов на другом устройстве вывода цветов. Если задать параметру uiAction значение CS_ENABLE, все последующие команды рисования контроллера домена будут отображать цвета, которые будут отображаться на целевом устройстве. Если параметр uiAction имеет значение CS_DISABLE, проверка правописания отключена. Однако текущее преобразование цвета не удаляется из контроллера домена. Это просто неактивно.

При вызове ColorMatchToTarget сначала выполняется преобразование цвета для целевого устройства, а затем преобразование устройства предварительного просмотра применяется к результатам первого преобразования. Используется в основном для проверки условий сопоставления гаммы. Перед использованием этой функции необходимо включить WCS для обоих контекстов устройств.

Эта функция не может быть каскадной. Хотя сопоставление цветов с целевым объектом включается, задав для uiAction значение CS_ENABLE, изменения в приложении в цветовом пространстве или методе сопоставления гамм игнорируются. Эти изменения вступают в силу при отключении сопоставления цветов с целевым объектом.

Примечание Утечка памяти не произойдет, если приложение не удалит преобразование с помощью CS_DELETE_TRANSFORM. Преобразование будет удалено при закрытии контекста устройства или при удалении цветового пространства приложения. Однако если преобразование не будет использоваться повторно или приложение не будет больше выполнять сопоставление цветов на контроллере домена, оно должно явно удалить преобразование, чтобы освободить занимаемую им память.
 
Параметру uiAction следует задать значение только CS_DELETE_TRANSFORM если управление цветом включено до вызова функции ColorMatchToTarget.

Требования

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

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