共用方式為

PCMSCALLBACKA 回呼函式 (icm.h)

  • 發行項

*PCMSCALLBACKA* (或 ApplyCallbackFunction) 是您實作的回呼函式，會在 SetupColorMatchingW 函式顯示的對話框執行時，更新 WCS 組態數據。 ApplyCallbackFunction 名稱是佔位符。 此回呼函式的實際名稱是由您的應用程式使用ICM提供。

語法

PCMSCALLBACKA Pcmscallbacka;

BOOL Pcmscallbacka(
  _tagCOLORMATCHSETUPA *unnamedParam1,
  LPARAM unnamedParam2
)
{...}

參數

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h

另請參閱