共用方式為

SetICMProfileA 函式 （wingdi.h）

  • 發行項

SetICMProfile 函式會將指定的色彩設定檔設定為指定裝置內容 （DC） 的輸出設定檔。

語法

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

參數

hdc

指定要在其中設定色彩設定檔的裝置內容。

lpFileName

指定要設定之色彩設定檔的路徑名稱。

傳回值

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

如果函式失敗傳回值會 FALSE。

言論

SetICMProfile 將色彩配置檔與裝置內容產生關聯。 它會成為該裝置內容的輸出配置檔。 色彩配置檔不需要與任何特定裝置相關聯。 也可以使用與裝置無關的配置檔，例如 sRGB。 如果色彩配置檔與硬體裝置沒有關聯，則會由 getICMProfile傳回，但不會由 EnumICMProfiles傳回。

請注意，在 Windows 95 或更新版本下，適用於印表機的 PostScript 裝置驅動程式會假設 CMYK 色彩模型。 因此，所有 PostScript 印表機都必須使用 CMYK 色彩設定檔。 Windows 2000 沒有這項限制。

SetICMProfile 僅支援相容 DC 中的 RGB 配置檔。

Windows 95/98/Me：Unicode Microsoft 層支援 SetICMProfileW。 若要使用此功能，您必須將特定檔案新增至您的應用程式，如 Windows 95/98/Me Systems上 Microsoft Layer for Unicode 中所述。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetICMProfile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wingdi.h
連結庫 Gdi32.lib
DLL Gdi32.dll

另請參閱