Metodo ImageAttributes::ClearOutputChannelColorProfile (gdiplusimageattributes.h)

Articolo
08/24/2023

Il metodo ImageAttributes::ClearOutputChannelColorProfile cancella l'impostazione del profilo di colore del canale di output per una categoria specificata.

Sintassi

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

Parametri

[in, optional] type

Tipo: ColorAdjustType

Elemento dell'enumerazione ColorAdjustType che specifica la categoria per cui l'impostazione del profilo del canale di output viene cancellata. 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 un profilo di canale di output per la categoria predefinita e un profilo di canale di output diverso per la categoria bitmap.

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 bitmap, le impostazioni predefinite si applicano alla categoria bitmap.

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 un profilo di canale di output e una matrice di regolazione per la categoria predefinita. Se si imposta il profilo del canale di output per la categoria bitmap chiamando ImageAttributes::SetOutputChannelColorProfile, il profilo del canale di output predefinito non verrà applicato alle bitmap. Se in seguito si cancella il profilo del canale di output bitmap chiamando ImageAttributes::ClearOutputChannelColorProfile, la categoria bitmap non restituirà il profilo del canale di output predefinito; invece, la categoria bitmap non avrà alcuna impostazione del profilo del canale di output. Analogamente, la categoria bitmap non verrà ripristinata nella matrice di regolazione dei colori predefinita; invece, la categoria bitmap non avrà alcuna matrice di regolazione dei colori.

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