共用方式為


(icm.h) PCMSCALLBACKW 回呼函式

*PCMSCALLBACKW* (或 ApplyCallbackFunction) 是您實作的回呼函式,可在 SetupColorMatchingW 函式顯示的對話方塊執行時更新 WCS 設定資料。 Name ApplyCallbackFunction 是預留位置。 此回呼函式的實際名稱是由您的應用程式使用 ICM 提供。

語法

PCMSCALLBACKW Pcmscallbackw;

BOOL Pcmscallbackw(
  _tagCOLORMATCHSETUPW *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 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 icm.h

另請參閱