Metodo ImageAttributes::ClearColorMatrix (gdiplusimageattributes.h)

Articolo
08/24/2023

Il metodo ImageAttributes::ClearColorMatrix cancella la matrice di regolazione dei colori per una categoria specificata.

Sintassi

Status ClearColorMatrix(
  [in, optional] ColorAdjustType type
);

Parametri

[in, optional] type

Tipo: ColorAdjustType

Elemento dell'enumerazione ColorAdjustType che specifica la categoria per cui viene cancellata la matrice di regolazione del colore. Il valore predefinito è ColorAdjustTypeDefault.

Valore restituito

Tipo: Stato

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

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

Commenti

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare una matrice di regolazione dei colori per la categoria predefinita, una matrice di regolazione del colore diversa per la categoria bitmap e ancora una matrice di regolazione del colore diversa per la categoria della penna.

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

Non appena si specifica un'impostazione di regolazione del colore o della scala di grigi per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a tale categoria. Si supponga, ad esempio, di specificare una matrice di regolazione del colore e un valore gamma per la categoria predefinita. Se si imposta una matrice di regolazione dei colori per la categoria della penna chiamando ImageAttributes::SetColorMatrix, la matrice di regolazione dei colori predefinita non verrà applicata alle penne. Se successivamente si cancella la matrice di regolazione del colore della penna chiamando ImageAttributes::ClearColorMatrix, la categoria della penna non verrà ripristinata alla matrice di regolazione predefinita; piuttosto, la categoria della penna non avrà una matrice di regolazione. Analogamente, la categoria della penna non ripristina il valore gamma predefinito; invece, la categoria della penna non avrà alcun valore gamma.

Requisiti


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