通过

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 系统上的 Unicode Microsoft 层中所述。

注意

wingdi.h 标头将 SetICMProfile 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wingdi.h
库 Gdi32.lib
DLL Gdi32.dll

另请参阅