Freigeben über


ImageAttributes::ClearOutputChannel-Methode (gdiplusimageattributes.h)

Die ImageAttributes::ClearOutputChannel-Methode löscht die CMYK-Ausgabekanaleinstellung (Cyan-Magenta-Yellow-Black) für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Ausgabekanaleinstellung gelöscht wird. Der Standardwert ist ColorAdjustTypeDefault.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Ausgabekanal für die Standardkategorie und einen anderen Ausgabekanal für die Bitmapkategorie angeben.

Die Standardeinstellungen für Farb- und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise niemals Anpassungseinstellungen für die Bitmapkategorie angeben, gelten die Standardeinstellungen für die Bitmapkategorie.

Sobald Sie eine Farb- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben einen Ausgabekanal und eine Anpassungsmatrix für die Standardkategorie an. Wenn Sie den Ausgabekanal für die Bitmapkategorie durch Aufrufen von ImageAttributes::SetOutputChannel festlegen, gilt der Standardausgabekanal nicht für Bitmaps. Wenn Sie den Bitmapausgabekanal später durch Aufrufen von ImageAttributes::ClearOutputChannel löschen, wird die Bitmapkategorie nicht zum Standardausgabekanal rückgängig machen. Stattdessen weist die Bitmapkategorie keine Ausgabekanaleinstellung auf. Ebenso rückgängig machen die Bitmapkategorie nicht zur Standardmäßigen Farbanpassungsmatrix. Stattdessen weist die Bitmapkategorie keine Farbanpassungsmatrix auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusimageattributes.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Coloradjusttype

ColorChannelFlags

ImageAttributes

ImageAttributes::ClearOutputChannelColorProfile

ImageAttributes::SetOutputChannel

ImageAttributes::SetOutputChannelColorProfile