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

注意

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

規格需求

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

另請參閱