ImageAttributes::ClearColorMatrix-Methode (gdiplusimageattributes.h)

Artikel
08/24/2023

Die ImageAttributes::ClearColorMatrix-Methode löscht die Farbanpassungsmatrix für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Farbanpassungsmatrix 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. Sie können beispielsweise eine Farbanpassungsmatrix für die Standardkategorie, eine andere Farbanpassungsmatrix für die Bitmapkategorie und dennoch eine andere Farbanpassungsmatrix für die Stiftkategorie 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 Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

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 eine Farbanpassungsmatrix und einen Gammawert für die Standardkategorie an. Wenn Sie eine Farbanpassungsmatrix für die Stiftkategorie festlegen, indem Sie ImageAttributes::SetColorMatrix aufrufen, gilt die Standardfarbanpassungsmatrix nicht für Stifte. Wenn Sie die Stiftfarbanpassungsmatrix später durch Aufrufen von ImageAttributes::ClearColorMatrix löschen, wird die Stiftkategorie nicht in die Standardanpassungsmatrix rückgängig machen, sondern die Stiftkategorie verfügt über keine Anpassungsmatrix. Ebenso rückgängig machen die Stiftkategorie nicht auf den Gammastandardwert, sondern die Stiftkategorie hat keinen Gammawert.

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