Función SetColorProfileElementSize (icm.h)

  • Artículo

Establece el tamaño de un elemento etiquetado en un perfil de color ICC.

Sintaxis

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

Parámetros

hProfile

Especifica un identificador para el perfil de color ICC en cuestión.

tagType

Identifica el elemento etiquetado.

pcbElement

Especifica el tamaño en el que se va a establecer el elemento etiquetado. Si cbSize es cero, esta función elimina el elemento etiquetado especificado. Si la etiqueta es una referencia, solo se elimina la entrada de la tabla de etiquetas, no los datos.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función producirá un error si hProfile no es un perfil ICC válido.

Para crear un nuevo elemento etiquetado en un perfil de color, use SetColorProfileElementSize para establecer el tamaño y, a continuación, use SetColorProfileElement para establecer el valor del elemento.

Si la etiqueta especificada ya existe en el perfil, SetColorProfileElementSize cambia el tamaño del elemento truncandolo o agregando ceros al final, como puede ser el caso.

Si la etiqueta especificada ya existe y es una referencia a otra etiqueta, SetColorProfileElementSize crea un área de datos nueva para la etiqueta que no se comparte.

Esta función no admite perfiles del Sistema de colores de Windows (WCS) CAMP, DMP y GMMP; dado que los elementos de perfil están asociados implícitamente y codificados de forma rígida a los tipos de etiquetas ICC y existen muchas bibliotecas de análisis XML sólidas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado icm.h
Library Mscms.lib
Archivo DLL Mscms.dll

Consulte también