Share via

Função EnumICMProfilesA (wingdi.h)

  • Artigo

A função EnumICMProfiles enumera os diferentes perfis de cor de saída aos quais o sistema dá suporte para um determinado contexto de dispositivo.

Sintaxe

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Parâmetros

hdc

Especifica o contexto de dispositivo.

proc

Especifica o endereço da instância de procedimento de uma função de retorno de chamada definida pelo aplicativo. (Consulte EnumICMProfilesProcCallback.)

param

Dados fornecidos pelo aplicativo que são passados para a função de retorno de chamada junto com as informações do perfil de cor.

Valor retornado

Essa função retornará zero se o aplicativo interrompeu a enumeração. O valor retornado será -1 se não houver perfis de cor para enumerar. Caso contrário, o valor retornado será o último valor retornado pela função de retorno de chamada.

Comentários

A função EnumICMProfiles retorna uma lista de perfis associados a um DC (contexto de dispositivo) e cujas configurações correspondem às do DC. É possível que um contexto de dispositivo contenha perfis de dispositivo que não estão associados a dispositivos de hardware específicos ou perfis de dispositivo que não correspondam às configurações do DC. O perfil sRGB é um exemplo. A função SetICMProfile é usada para associar esses tipos de perfis a um DC. A função GetICMProfile pode ser usada para recuperar um perfil que não é enumerado pela função EnumICMProfiles .

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

Observação

O cabeçalho wingdi.h define EnumICMProfiles 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

   
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