Metodo ImageAttributes::ClearRemapTable (gdiplusimageattributes.h)

Articolo
02/29/2024

Il metodo ImageAttributes::ClearRemapTable cancella la tabella color-remap per una categoria specificata.

Sintassi

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

Parametri

[in, optional] type

Tipo: ColorAdjustType

Elemento dell'enumerazione ColorAdjustType che specifica la categoria per cui la tabella di rimap 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 una tabella di remap per la categoria predefinita, una tabella di remap diversa per la categoria bitmap e ancora una tabella di rimap diversa 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 tabella di rimap e un valore gamma per la categoria predefinita. Se si imposta la tabella remap per la categoria di penna chiamando ImageAttributes::SetRemapTable, la tabella di rimap predefinita non verrà applicata alle penne. Se in seguito si cancella la tabella di rimap della penna chiamando ImageAttributes::ClearRemapTable, la categoria di penna non verrà ripristinata nella tabella di rimap predefinita; invece, la categoria di penna non avrà una tabella di rimap. Analogamente, la categoria di penna non verrà ripristinata al valore gamma predefinito; invece, la categoria di penna non avrà alcun valore gamma.

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