Функция обратного вызова PCMSCALLBACKW (icm.h)
*PCMSCALLBACKW* (или ApplyCallbackFunction) — это реализованная функция обратного вызова, которая обновляет данные конфигурации WCS во время выполнения диалогового окна, отображаемого функцией SetupColorMatchingW . Имя ApplyCallbackFunction является заполнителем. Фактическое имя этой функции обратного вызова предоставляется приложением с помощью ICM.
Синтаксис
PCMSCALLBACKW Pcmscallbackw;
BOOL Pcmscallbackw(
_tagCOLORMATCHSETUPW *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Параметры
unnamedParam1
Указатель на структуру COLORMATCHSETUPW , содержащую данные конфигурации WCS.
unnamedParam2
Содержит значение, предоставленное приложением.
Возвращаемое значение
Если эта функция выполняется успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Функция обратного вызова может задать расширенные сведения об ошибке, вызвав Метод SetLastError.
Комментарии
Функция ApplyCallbackFunction используется для изменения конфигурации WCS для устройства при отображении диалогового окна Управление цветом. Диалоговое окно Управление цветом отображается функцией SetupColorMatchingW .
Если указана функция обратного вызова, в правом нижнем углу диалогового окна отображается кнопка Применить . При нажатии кнопки Применить функция обратного вызова немедленно обновляет конфигурацию настраиваемого устройства. Диалоговое окно Управление цветом остается на экране.
Приложение предоставляет функцию обратного вызова в WCS, сохраняя адрес функции обратного вызова в структуре COLORMATCHSETUPW , которая передается функции SetupColorMatchingW . Адрес хранится в элементе lPfnApplyCallback структуры COLORMATCHSETUP . Члену dwFlags следует задать значение CMS_USEAPPLYCALLBACK, иначе функция обратного вызова будет игнорироваться.
Значение, предоставленное приложением, может быть передано функции обратного вызова. Перед вызовом функции SetupColorMatchingW приложение может сохранить значение в элементе lParamApplyCallback структуры COLORMATCHSETUPW . При вызове функции обратного вызова значение в элементе структуры lParamApplyCallback будет передано функции обратного вызова в ее параметре lParam .
Функция обратного вызова является полностью необязательной. Если он не указан, кнопка Применить не отображается в диалоговом окне Управление цветом. Корпорация Майкрософт настоятельно рекомендует, чтобы приложение предоставлял функцию обратного вызова.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |