GdipSetImageAttributesNoOp()

Resultat.i = GdipSetImageAttributesNoOp(*imageattr, type.i, enableFlag.i)

*imageattr

[in] Pointeur sur un objet ImageAttributes.

type.i

[in] Elément de l'énumération ColorAdjustType qui indique la catégorie pour laquelle le réglage des couleurs est appliquée.

enableFlag.i

[in] Valeur booléenne. Si enableFlag vaut #True, le réglage des couleurs est appliqué, sinon il ne l'est pas.

Cette fonction permet d'activer ou de désactiver le réglage des couleurs pour une catégorie donnée. Après avoir désactivé le réglage des couleurs pour une catégorie donnée, on peut rétablir les paramètres de réglage des couleurs qui étaient en vigueur avant la désactivation en utilisant la fonction avec le paramètre enableFlag à #True. Idem dans l'autre sens.

Un objet ImageAttributes conserve les paramètres de réglage des couleurs et des nuances de gris pour cinq catégories de réglages : par défaut, bitmap, brush, pen et text.

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 de réglage propres. Par exemple, si vous ne spécifiez jamais de paramètres de réglage pour la catégorie pen, les paramètres par défaut s'appliquent à cette catégorie. 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 de réglage par défaut ne s'appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez un ensemble de paramètres de réglage pour la catégorie par défaut. Si vous définissez le seuil (plage de transparence) de la catégorie pen en passant #ColorAdjustTypePen à la fonction GdipSetImageAttributesThreshold(), aucun des paramètres de réglage par défaut ne s'appliquera aux pen.
Vous pouvez rétablir les réglages par défaut pour cette catégorie en utilisant la fonction GdipResetImageAttributes().

L'exemple charge une image bmp et l'affiche deux fois. L'image de gauche est l'image d'origine qui ne changera pas. L'image de droite va subir un inclinaison des couleurs (ajout au vert de 60% de la valeur de la couche alpha et ajout au rouge les 100% de la valeur du vert). En cliquant sur le bouton, on peut soit désactiver soit activer le réglage des couleurs. L'image modifiée est affichée à droite.