ImageAttributes ::Reset, méthode (gdiplusimageattributes.h)

La méthode ImageAttributes ::Reset efface tous les paramètres d’ajustement des couleurs et des nuances de gris pour une catégorie spécifiée.

Syntaxe

C++
Status Reset(
  [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 l’ajustement de couleur est réinitialisé. La valeur par défaut est ColorAdjustTypeDefault.

Valeur de retour

Type : d’é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.

Remarques

Un ImageAttributes objet conserve les paramètres de couleur 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 une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap, et toujours une valeur gamma différente pour la catégorie de stylet.

Les paramètres d’ajustement 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 de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

Dès que vous spécifiez un paramètre d’ajustement de couleur ou de nuance de gris pour une certaine catégorie, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Vous pouvez rétablir les paramètres par défaut de cette catégorie en appelant ImageAttributes ::Reset. Par exemple, supposons que vous spécifiez une valeur gamma pour la catégorie par défaut. Si vous définissez la valeur gamma pour la catégorie de stylet en appelant ImageAttributes ::SetGamma, la valeur gamma par défaut ne s’applique pas aux stylos. Si vous passez ultérieurement ColorAdjustTypePen à la méthode ImageAttributes ::Reset, la catégorie de stylet revient à la valeur gamma par défaut.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP, 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 gdiplusimageattributes.h (include Gdiplus.h)
bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

bitmap

ColorAdjustType

image

ImageAttributes

ImageAttributes ::ClearNoOp

ImageAttributes ::SetNoOp

de métafichier

recoloriage