Partager via

SetICMProfileA, fonction (wingdi.h)

  • Article

La fonction SetICMProfile définit un profil de couleur spécifié comme profil de sortie pour un contexte d’appareil spécifié (DC).

Syntaxe

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Paramètres

hdc

Spécifie un contexte d’appareil dans lequel définir le profil de couleur.

lpFileName

Spécifie le nom du chemin d’accès du profil de couleur à définir.

Valeur de retour

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE.

Remarques

SetICMProfile associe un profil de couleur à un contexte d’appareil. Il devient le profil de sortie de ce contexte d’appareil. Le profil de couleur n’a pas besoin d’être associé à un appareil particulier. Les profils indépendants de l’appareil, tels que sRGB, peuvent également être utilisés. Si le profil de couleur n’est pas associé à un périphérique matériel, il est retourné par getICMProfile, mais pas par EnumICMProfiles.

Notez que, sous Windows 95 ou version ultérieure, le pilote de périphérique PostScript pour les imprimantes suppose un modèle de couleur CMYK. Par conséquent, toutes les imprimantes PostScript doivent utiliser un profil de couleur CMYK. Windows 2000 n’a pas cette limitation.

SetICMProfile prend uniquement en charge les profils RVB dans les contrôleurs de domaine compatibles.

Windows 95/98/Me : SetICMProfileW est pris en charge par la couche Microsoft pour Unicode. Pour l’utiliser, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur Windows 95/98/Me Systems.

Note

L’en-tête wingdi.h définit SetICMProfile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête wingdi.h
bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi