pcMSCALLBACKW 回调函数 (icm.h)

*PCMSCALLBACKW* (或 ApplyCallbackFunction) 是实现的回调函数,可在 SetupColorMatchingW 函数显示的对话框执行时更新 WCS 配置数据。 名称 ApplyCallbackFunction 是占位符。 此回调函数的实际名称由应用程序使用 ICM 提供。

语法

PCMSCALLBACKW Pcmscallbackw;

BOOL Pcmscallbackw(
  _tagCOLORMATCHSETUPW *unnamedParam1,
  LPARAM unnamedParam2
)
{...}

parameters

unnamedParam1

指向包含 WCS 配置数据的 COLORMATCHSETUPW 结构的指针。

unnamedParam2

包含应用程序提供的值。

返回值

如果此函数成功,则返回值为 TRUE

如果此函数失败,则返回值为 FALSE。 回调函数可以通过调用 SetLastError 来设置扩展的错误信息。

注解

ApplyCallbackFunction 函数用于在显示“颜色管理”对话框时更改设备的 WCS 配置。 “颜色管理”对话框由 SetupColorMatchingW 函数显示。

如果提供了回调函数,对话框右下角会显示“ 应用 ”按钮。 选择“ 应用 ”按钮时,回调函数会立即更新所设置设备的配置。 “颜色管理”对话框仍保留在屏幕上。

应用程序通过将回调函数的地址存储在传递给 SetupColorMatchingW 函数的 COLORMATCHSETUPW 结构中,向 WCS 提供回调函数。 地址存储在 COLORMATCHSETUP 结构的 lPfnApplyCallback 成员中。 dwFlags 成员应设置为 CMS_USEAPPLYCALLBACK,否则将忽略回调函数。

应用程序提供的值可以传递给回调函数。 在调用 SetupColorMatchingW 函数之前,应用程序可以将值存储在 COLORMATCHSETUPW 结构的 lParamApplyCallback 成员中。 调用回调函数时, lParamApplyCallback 结构成员中的值将传递到其 lParam 参数中的回调函数。

回调函数是完全可选的。 如果未提供,“颜色管理”对话框中不会显示 “应用 ”按钮。 Microsoft 强烈建议应用程序提供回调函数。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h

另请参阅