SetICMProfileW 함수(wingdi.h)

  • 아티클

SetICMProfile 함수는 지정된 색 프로필을 지정된 DC(디바이스 컨텍스트)의 출력 프로필로 설정합니다.

구문

BOOL SetICMProfileW(
  HDC    hdc,
  LPWSTR lpFileName
);

매개 변수

hdc

색 프로필을 설정할 디바이스 컨텍스트를 지정합니다.

lpFileName

설정할 색 프로필의 경로 이름을 지정합니다.

반환 값

이 함수가 성공하면 반환 값은 TRUE입니다.

이 함수가 실패하면 반환 값은 FALSE입니다.

설명

SetICMProfile은 색 프로필을 디바이스 컨텍스트와 연결합니다. 해당 디바이스 컨텍스트의 출력 프로필이 됩니다. 색 프로필은 특정 디바이스와 연결할 필요가 없습니다. sRGB와 같은 디바이스 독립적 프로필도 사용할 수 있습니다. 색 프로필이 하드웨어 디바이스와 연결되지 않은 경우 GetICMProfile에서 반환되지만 EnumICMProfiles에서는 반환되지 않습니다.

Windows 95 이상에서 프린터용 PostScript 디바이스 드라이버는 CMYK 색 모델을 가정합니다. 따라서 모든 PostScript 프린터는 CMYK 색 프로필을 사용해야 합니다. Windows 2000에는 이 제한이 없습니다.

SetICMProfile 은 호환되는 DC에서 RGB 프로필만 지원합니다.

Windows 95/98/Me: SetICMProfileW 는 Microsoft Layer for Unicode에서 지원됩니다. 이를 사용하려면 Windows 95/98/Me 시스템의 유니코드용 Microsoft Layer에 설명된 대로 특정 파일을 애플리케이션에 추가해야 합니다.

참고

wingdi.h 헤더는 SETICMProfile을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wingdi.h
라이브러리 Gdi32.lib
DLL Gdi32.dll

추가 정보