共用方式為

ColorMatchToTarget 函式 (wingdi.h)

  • 發行項

ColorMatchToTarget 函式可讓您預覽色彩，因為它們會出現在目標裝置上。

語法

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

參數

hdc

指定用於預覽的裝置內容，通常是畫面。

hdcTarget

指定目標裝置內容，通常是印表機。

action

可以具有下列其中一個值的常數。

 

值 意義
CS_ENABLE
 將色彩對應至目標裝置的色彩遊戲。 這可啟用色彩校訂。 所有後續繪製命令都會呈現DC的色彩，因為它們會顯示在目標裝置上。
CS_DISABLE
 停用色彩校訂。
CS_DELETE_TRANSFORM
 如果目標設定檔已啟用色彩管理，請加以停用，並刪除串連轉換。

傳回值

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。

備註

ColorMatchToTarget 可用來證明另一個色彩輸出裝置上色彩輸出裝置的色彩。 將 uiAction 參數設定為 CS_ENABLE會導致所有後續繪圖命令轉譯 DC 的色彩，因為它們會顯示在目標裝置上。 如果 uiAction 設定為CS_DISABLE，則會關閉校訂。 不過，目前的色彩轉換不會從 DC 中刪除。 它只是非使用中。

呼叫 ColorMatchToTarget 時，會先執行目標裝置的色彩轉換，然後將轉換套用至預覽裝置的結果。 這主要用於檢查遊戲對應條件。 使用此函式之前，您必須針對這兩個裝置內容啟用 WCS。

無法串聯此函式。 雖然將 uiAction 設定為CS_ENABLE來啟用目標色彩對應，但會忽略對色彩空間或遊戲對應方法的應用程式變更。 這些變更會在停用目標色彩對應時生效。

注意 如果應用程式未使用 CS_DELETE_TRANSFORM刪除轉換，則不會發生記憶體流失。 當裝置內容 (DC) 關閉，或刪除應用程式色彩空間時，將會刪除轉換。 不過，如果轉換不會再次使用，或應用程式不會在 DC 上執行任何其他色彩比對，則應該明確地刪除轉換以釋放它佔用的記憶體。
 
只有在呼叫 ColorMatchToTarget 函式之前啟用色彩管理時，uiAction 參數才應該設定為 CS_DELETE_TRANSFORM。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱