Condividi tramite

Funzione SetICMProfileA (wingdi.h)

  • Articolo

La funzione SetICMProfile imposta un profilo colore specificato come profilo di output per un contesto di dispositivo specificato.

Sintassi

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Parametri

hdc

Specifica un contesto di dispositivo in cui impostare il profilo colore.

lpFileName

Specifica il nome del percorso del profilo colore da impostare.

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE.

Osservazioni

SetICMProfile associa un profilo colore a un contesto di dispositivo. Diventa il profilo di output per il contesto di dispositivo. Il profilo di colore non deve essere associato a un dispositivo specifico. È anche possibile usare profili indipendenti dal dispositivo, ad esempio sRGB. Se il profilo di colore non è associato a un dispositivo hardware, verrà restituito da GetICMProfile, ma non da EnumICMProfiles.

Si noti che in Windows 95 o versione successiva il driver di dispositivo PostScript per le stampanti presuppone un modello di colore CMYK. Pertanto, tutte le stampanti PostScript devono usare un profilo colore CMYK. Windows 2000 non ha questa limitazione.

SetICMProfile supporta solo i profili RGB nei controller di dominio compatibili.

Windows 95/98/Me: SetICMProfileW è supportato dal livello Microsoft per Unicode. Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Livello Microsoft per Unicode in Windows 95/98/Me Systems.

Nota

L'intestazione wingdi.h definisce SetICMProfile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione wingdi.h
libreria Gdi32.lib
dll Gdi32.dll

Vedere anche