Share via

Função SetColorProfileElementSize (icm.h)

  • Artigo

Define o tamanho de um elemento marcado em um perfil de cor ICC.

Sintaxe

BOOL SetColorProfileElementSize(
  HPROFILE hProfile,
  TAGTYPE  tagType,
  DWORD    pcbElement
);

Parâmetros

hProfile

Especifica um identificador para o perfil de cor ICC em questão.

tagType

Identifica o elemento marcado.

pcbElement

Especifica o tamanho para o qual definir o elemento marcado. Se cbSize for zero, essa função excluirá o elemento marcado especificado. Se a marca for uma referência, somente a entrada da tabela de marcas será excluída, não os dados.

Retornar valor

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

Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função falhará se hProfile não for um perfil ICC válido.

Para criar um novo elemento marcado em um perfil de cor, use SetColorProfileElementSize para definir o tamanho e, em seguida, use SetColorProfileElement para definir o valor do elemento.

Se a marca especificada já existir no perfil, SetColorProfileElementSize alterará o tamanho do elemento truncando-o ou adicionando zeros no final, como o caso pode ser.

Se a marca especificada já existir e for uma referência a outra marca, SetColorProfileElementSize criará uma nova área de dados para a marca que não é compartilhada.

Essa função não dá suporte a perfis do WCS (Sistema de Cores do Windows) CAMP, DMP e GMMP; porque os elementos de perfil são implicitamente associados e embutidos em código para tipos de marca ICC e existem muitas bibliotecas de análise XML robustas.

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]
Cabeçalho icm.h
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também