ImageAttributes::ClearOutputChannelColorProfile, méthode (gdiplusimageattributes.h)
La méthode ImageAttributes::ClearOutputChannelColorProfile efface le paramètre de profil de couleur du canal de sortie pour une catégorie spécifiée.
Syntaxe
Status ClearOutputChannelColorProfile(
[in, optional] ColorAdjustType type
);
Paramètres
[in, optional] type
Type : ColorAdjustType
Élément de l’énumération ColorAdjustType qui spécifie la catégorie pour laquelle le paramètre de profil de canal de sortie est effacé. La valeur par défaut est ColorAdjustTypeDefault.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Notes
Un objet ImageAttributes conserve les paramètres de couleurs et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier un profil de canal de sortie pour la catégorie par défaut et un autre profil de canal de sortie pour la catégorie bitmap.
Les paramètres de réglage des couleurs et des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie bitmap, les paramètres par défaut s’appliquent à la catégorie bitmap.
Dès que vous spécifiez un paramètre de réglage des couleurs ou des nuances de gris pour une catégorie donnée, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez un profil de canal de sortie et une matrice d’ajustement pour la catégorie par défaut. Si vous définissez le profil du canal de sortie pour la catégorie bitmap en appelant ImageAttributes::SetOutputChannelColorProfile, le profil de canal de sortie par défaut ne s’applique pas aux bitmaps. Si vous effacez ultérieurement le profil du canal de sortie bitmap en appelant ImageAttributes::ClearOutputChannelColorProfile, la catégorie bitmap ne reviendra pas au profil de canal de sortie par défaut ; au lieu de cela, la catégorie bitmap n’aura aucun paramètre de profil de canal de sortie. De même, la catégorie bitmap ne revient pas à la matrice de réglage des couleurs par défaut ; au lieu de cela, la catégorie bitmap n’aura pas de matrice d’ajustement des couleurs.
Configuration requise
| Client minimal pris en charge | Windows XP, 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 | gdiplusimageattributes.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |
Voir aussi
ImageAttributes::ClearOutputChannel