Функция ApplyCallbackFunction

Функция ApplyCallbackFunction - это функция обратного вызова, которая обновляет данные конфигурации ICM в то время, когда выполняется  диалоговое окно, показываемое функцией SetupColorMatching. Название ApplyCallbackFunction - это метка - заполнитель. Фактическое название этой функции обратного вызова предоставляется приложением, которое использует ICM.

Синтаксис

Параметры

pColorMatchSetup

Указатель на структуру COLORMATCHSETUP, которая содержит данные конфигурации ICM.

lParam

Содержит значение, поставляемое приложением.

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

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

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

Замечания

Функция ApplyCallbackFunction используется, чтобы изменить профиль ICM для устройства, в то время когда диалоговое окно Управление цветом (Color Management) показывается на экране. Диалоговое окно Управление цветом показывается функцией SetupColorMatching.

Если функция обратного вызова обеспечивается, то кнопка Применить (Apply) показывается внизу справа диалогового окна. Когда Вы выбираете кнопку  Применить, функция обратного вызова немедленно обновляет профиль для настраиваемого устройства. Диалоговое окно Управление цветом остается на экране.

Приложение предоставляет функцию обратного вызова ICM, сохраняя адрес функции обратного вызова в структуре COLORMATCHSETUP, которая передается функции SetupColorMatching. Адрес сохраняется в  члене lpfnApplyCallback структуры COLORMATCHSETUP. Член структуры dwFlags  должен быть установлен в CMS_USEAPPLYCALLBACK, или же функция обратного вызова игнорируется.

Значение, поставляемое приложением, может передаваться функции обратного вызова. Перед активизацией функции SetupColorMatching, приложение может хранить значение в члене lParamApplyCallback структуры COLORMATCHSETUP. Когда функция обратного вызова активизируется, значение члена структуры lParamApplyCallback должно быть передано в функцию обратного вызова в ее параметре lParam.

Функция обратного вызова является полностью дополнительной. Если она не предоставляется, кнопка Применить (Apply) не появляется в диалоговом окне Управление цветом (Color Management). Microsoft настоятельно рекомендует, чтобы ваше приложение предоставляло функцию обратного вызова.

Смотри также 

Назад в оглавление

На главную страницу

На оглавление справки