Função SetICMProfileA (wingdi.h)

A função SetICMProfile define um perfil de cor especificado como o perfil de saída para um DC (contexto de dispositivo) especificado.

Sintaxe

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Parâmetros

hdc

Especifica um contexto de dispositivo no qual definir o perfil de cor.

lpFileName

Especifica o nome do caminho do perfil de cor a ser definido.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE.

Comentários

SetICMProfile associa um perfil de cor a um contexto de dispositivo. Ele se torna o perfil de saída desse contexto de dispositivo. O perfil de cor não precisa ser associado a nenhum dispositivo específico. Perfis independentes do dispositivo, como sRGB, também podem ser usados. Se o perfil de cor não estiver associado a um dispositivo de hardware, ele será retornado por GetICMProfile, mas não por EnumICMProfiles.

Observe que, no Windows 95 ou posterior, o driver de dispositivo PostScript para impressoras pressupõe um modelo de cores CMYK. Portanto, todas as impressoras PostScript devem usar um perfil de cor CMYK. O Windows 2000 não tem essa limitação.

SetICMProfile dá suporte apenas a perfis RGB em DCs compatíveis.

Windows 95/98/Me: SetICMProfileW é compatível com a Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito no Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Requisitos

Confira também

• Conceitos básicos de gerenciamento de cores
• Funções
• EnumICMProfilesW
• GetICMProfileW