Condividi tramite

Funzione SetColorProfileElement (icm.h)

  • Articolo

Imposta i dati dell'elemento per un elemento profilo contrassegnato in un profilo di colore ICC.

Sintassi

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

Parametri

hProfile

Specifica un handle per il profilo ICC in questione.

tag

Identifica l'elemento contrassegnato.

dwOffset

Specifica l'offset dal primo byte dei dati dell'elemento contrassegnati in corrispondenza del quale iniziare a scrivere.

pcbElement

Puntatore a una variabile contenente il numero di byte di dati da scrivere. Al ritorno, contiene il numero di byte effettivamente scritti.

pElement

Puntatore a un buffer contenente i dati da scrivere nell'elemento contrassegnato nel profilo di colore.

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.

Se il profilo di colore non viene aperto per l'autorizzazione di lettura/scrittura, questa funzione ha esito negativo.

Se dwOffset supera le dimensioni impostate per l'elemento contrassegnato specificato, questa funzione ha esito negativo.

Se dwOffset + *pcbSize è maggiore delle dimensioni dell'elemento specificato, questa funzione scrive solo quanti byte si adattano alla dimensione corrente dell'elemento.

Tutti i dati esistenti nella parte specificata dell'elemento contrassegnato vengono sovrascritti quando questa funzione riesce.

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

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche