Méthode ImageAttributes::ClearColorMatrix (gdiplusimageattributes.h)

Article
08/24/2023

La méthode ImageAttributes::ClearColorMatrix efface la matrice d’ajustement des couleurs pour une catégorie spécifiée.

Syntaxe

Status ClearColorMatrix(
  [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 la matrice d’ajustement de couleur est effacée. 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 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 matrice d’ajustement des couleurs pour la catégorie par défaut, une matrice d’ajustement des couleurs différente pour la catégorie bitmap et une matrice d’ajustement de couleur différente pour la catégorie de stylet.

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 leurs propres paramètres d’ajustement. 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 de réglage des couleurs ou des nuances de gris pour une certaine catégorie, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une matrice d’ajustement des couleurs et une valeur gamma pour la catégorie par défaut. Si vous définissez une matrice d’ajustement des couleurs pour la catégorie de stylet en appelant ImageAttributes::SetColorMatrix, la matrice d’ajustement des couleurs par défaut ne s’applique pas aux stylets. Si vous effacez ultérieurement la matrice d’ajustement des couleurs du stylet en appelant ImageAttributes::ClearColorMatrix, la catégorie de stylet ne reviendra pas à la matrice d’ajustement par défaut ; au lieu de cela, la catégorie de stylet n’aura pas de matrice d’ajustement. De même, la catégorie de stylet ne rétablit pas la valeur gamma par défaut ; au lieu de cela, la catégorie de stylet n’aura pas de valeur gamma.

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 (incluez Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll