Função SetICMProfileA (wingdi.h)

  • Artigo

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.

Observação

O cabeçalho wingdi.h define SetICMProfile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também