Funzione SetColorProfileElementSize (icm.h)

Imposta le dimensioni di un elemento contrassegnato in un profilo di colore ICC.

Sintassi

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

Parametri

hProfile

Specifica un handle per il profilo di colore ICC in questione.

tagType

Identifica l'elemento contrassegnato.

pcbElement

Specifica le dimensioni su cui impostare l'elemento contrassegnato. Se cbSize è zero, questa funzione elimina l'elemento contrassegnato specificato. Se il tag è un riferimento, viene eliminata solo la voce della tabella tag, non i dati.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Questa funzione avrà esito negativo se hProfile non è un profilo ICC valido.

Per creare un nuovo elemento contrassegnato in un profilo di colore, usare SetColorProfileElementSize per impostare le dimensioni, quindi usare SetColorProfileElement per impostare il valore dell'elemento.

Se il tag specificato esiste già nel profilo, SetColorProfileElementSize modifica le dimensioni dell'elemento troncandolo o aggiungendo zero alla fine, come può essere il caso.

Se il tag specificato esiste già ed è un riferimento a un altro tag, SetColorProfileElementSize crea una nuova area dati per il tag non condiviso.

Questa funzione non supporta i profili DI Windows Color System (WCS) CAMP, DMP e GMMP; poiché gli elementi del profilo sono associati in modo implicito ai tipi di tag ICC e esistono molte librerie di analisi XML affidabili.

Requisiti

Vedi anche

• Concetti di base sulla gestione dei colori
• Funzioni
• SetColorProfileElement