Funzione SetICMProfileA (wingdi.h)

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

Sintassi

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Parametri

hdc

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

lpFileName

Specifica il nome del percorso del profilo di 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.

Commenti

SetICMProfile associa un profilo di colore a un contesto del dispositivo. Diventa il profilo di output per il contesto del dispositivo. Il profilo di colore non deve essere associato a alcun dispositivo specifico. I profili indipendenti dal dispositivo, ad esempio sRGB, possono essere usati anche. 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 versioni successive il driver di dispositivo PostScript per le stampanti presuppone un modello di colore CMYK. Pertanto, tutte le stampanti PostScript devono usare un profilo di colore CMYK. Windows 2000 non ha questa limitazione.

SetICMProfile supporta solo i profili RGB nelle schede di dominio compatibili.

Windows 95/98/Me: SetICMProfileW è supportato da Microsoft Layer for Unicode. Per usarlo, è necessario aggiungere determinati file all'applicazione, come descritto in Microsoft Layer for 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche