Metodo ImageAttributes::SetColorMatrices (gdiplusimageattributes.h)

Articolo
08/24/2023

Il metodo ImageAttributes::SetColorMatrices imposta la matrice di regolazione dei colori e la matrice di regolazione della scala grigia per una categoria specificata.

Sintassi

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

Parametri

[in] colorMatrix

Tipo: const ColorMatrix*

Puntatore a una matrice di regolazione dei colori 5×5.

[in] grayMatrix

Tipo: const ColorMatrix*

Puntatore a una matrice di regolazione della scala grigia 5×5.

[in, optional] mode

Tipo: ColorMatrixFlags

Elemento dell'enumerazione ColorMatrixFlags che specifica il tipo di immagine e colore che sarà interessato dalle matrici di regolazione dei colori e della regolazione della scala grigia. Il valore predefinito è ColorMatrixFlagsDefault.

[in, optional] type

Tipo: ColorAdjustType

Elemento dell'enumerazione ColorAdjustType che specifica la categoria per cui sono impostate le matrici di regolazione del colore e di regolazione della scala grigia. Il valore predefinito è ColorAdjustTypeDefault.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Un oggetto ImageAttributes gestisce le impostazioni di colore e scala di grigio per cinque categorie di regolazione: impostazione predefinita, bitmap, pennello, penna e testo. Ad esempio, è possibile specificare matrici di regolazione per la categoria predefinita, matrici di regolazione diverse per la categoria bitmap e matrici di regolazione ancora diverse per la categoria di penna.

Le impostazioni predefinite di regolazione del colore e della scala grigia si applicano a tutte le categorie che non hanno impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria di penna, le impostazioni predefinite si applicano alla categoria di penna.

Non appena si specifica un'impostazione di regolazione del colore o della scala grigia per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a tale categoria. Si supponga, ad esempio, di specificare una raccolta di impostazioni di regolazione per la categoria predefinita. Se si impostano le matrici di regolazione dei colori e della scala grigia per la categoria di penna passando ColorAdjustTypePen al metodo ImageAttributes::SetColorMatrices , none le impostazioni di regolazione predefinite verranno applicate alle penne.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusimageattributes.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll