Compartilhar via

Função SetICMProfileA (wingdi.h)

  • Artigo

A função SetICMProfile define um perfil de cor especificado como o perfil de saída de 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.

Valor de retorno

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

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

Observações

SetICMProfile associa um perfil de cor a um contexto de dispositivo. Ele se torna o perfil de saída para esse contexto de dispositivo. O perfil de cor não precisa ser associado a nenhum dispositivo específico. Perfis independentes de 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 tem suporte da Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito em Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho wingdi.h
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também