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

Article
02/26/2024

La méthode ImageAttributes ::SetColorMatrices définit la matrice d’ajustement des couleurs et la matrice d’ajustement des nuances de gris pour une catégorie spécifiée.

Syntaxe

Status SetColorMatrices(
  [in]           const ColorMatrix *colorMatrix,
  [in]           const ColorMatrix *grayMatrix,
  [in, optional] ColorMatrixFlags  mode,
  [in, optional] ColorAdjustType   type
);

Paramètres

[in] colorMatrix

Type : const ColorMatrix*

Pointeur vers une matrice d’ajustement des couleurs de 5×5.

[in] grayMatrix

Type : const ColorMatrix*

Pointeur vers une matrice d’ajustement de nuances de gris 5×5.

[in, optional] mode

Type : ColorMatrixFlags

Élément de l’énumération ColorMatrixFlags qui spécifie le type d’image et la couleur qui seront affectés par les matrices d’ajustement de couleur et d’ajustement des nuances de gris. La valeur par défaut est ColorMatrixFlagsDefault.

[in, optional] type

Type : ColorAdjustType

Élément de l’énumération ColorAdjustType qui spécifie la catégorie pour laquelle les matrices d’ajustement de couleur et d’ajustement des nuances de gris sont définies. 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 .

Remarques

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 des matrices d’ajustement pour la catégorie par défaut, différentes matrices d’ajustement pour la catégorie bitmap et des matrices d’ajustement différentes 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 collection de paramètres d’ajustement pour la catégorie par défaut. Si vous définissez les matrices d’ajustement des couleurs et d’ajustement des nuances de gris pour la catégorie de stylet en passant ColorAdjustTypePen à la méthode ImageAttributes ::SetColorMatrices , aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.

Configuration requise

Condition requise	Valeur
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