ImageAttributes::ClearOutputChannelColorProfile-Methode (gdiplusimageattributes.h)

Artikel
08/24/2023

Die ImageAttributes::ClearOutputChannelColorProfile-Methode löscht die Einstellung des Ausgabekanalfarbprofils für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Einstellung des Ausgabekanalprofils 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, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Beispielsweise können Sie ein Ausgabekanalprofil für die Standardkategorie und ein anderes Ausgabekanalprofil 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 nie Anpassungseinstellungen für die Bitmapkategorie angeben, gelten die Standardeinstellungen für die Bitmapkategorie.

Sobald Sie eine Einstellung zur Farb- oder Graustufenanpassung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben ein Ausgabekanalprofil und eine Anpassungsmatrix für die Standardkategorie an. Wenn Sie das Ausgabekanalprofil für die Bitmapkategorie festlegen, indem Sie ImageAttributes::SetOutputChannelColorProfile aufrufen, gilt das Standardausgabekanalprofil nicht für Bitmaps. Wenn Sie später das Bitmapausgabekanalprofil löschen, indem Sie ImageAttributes::ClearOutputChannelColorProfile aufrufen, wird die Bitmapkategorie nicht in das Standardausgabekanalprofil rückgängig machen, sondern die Bitmapkategorie verfügt über keine Ausgabekanalprofileinstellung. Ebenso rückgängig machen die Bitmapkategorie nicht in die Standardmatrix für die Farbanpassung ein, sondern die Bitmapkategorie verfügt über keine Farbanpassungsmatrix.

Anforderungen


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