ImageAttributes::ClearOutputChannel-Methode (gdiplusimageattributes.h)

Artikel
02/26/2024

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