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 Unicode 层中所述。

注意

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

要求

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

另请参阅