SetICMProfileA, fonction (wingdi.h)

Article
03/04/2024

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

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 retournée

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 pour 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 CMJN. Par conséquent, toutes les imprimantes PostScript doivent utiliser un profil de couleur CMJN. Windows 2000 n’a pas cette limitation.

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

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

Notes

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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Partager via