Condividi tramite


Metodo ImageAttributes::ClearOutputChannel (gdiplusimageattributes.h)

Il metodo ImageAttributes::ClearOutputChannel cancella l'impostazione del canale di output cyan-magenta-yellow-black (CMYK) per una categoria specificata.

Sintassi

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

Parametri

[in, optional] type

Tipo: ColorAdjustType

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

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

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

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

Vedi anche

Coloradjusttype

ColorChannelFlags

Imageattributes

ImageAttributes::ClearOutputChannelColorProfile

ImageAttributes::SetOutputChannel

ImageAttributes::SetOutputChannelColorProfile