ImageAttributes::ClearGamma-Methode (gdiplusimageattributes.h)

Artikel
08/24/2023

Die ImageAttributes::ClearGamma-Methode deaktiviert die Gammakorrektur für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Gammakorrektur deaktiviert ist. 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 Gammawert für die Standardkategorie, einen anderen Gammawert für die Bitmapkategorie und noch einen anderen Gammawert 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 Farb- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben einen Gammawert und eine Farbanpassungsmatrix für die Standardkategorie an. Wenn Sie den Gammawert für die Stiftkategorie durch Aufrufen von ImageAttributes::SetGamma festlegen, gilt der Standard-Gammawert nicht für Stifte. Wenn Sie den Gammawert des Stifts später durch Aufrufen von ImageAttributes::ClearGamma löschen, wird die Stiftkategorie nicht auf den Standard-Gammawert rückgängig machen. Stattdessen weist die Stiftkategorie keinen Gammawert auf. Ebenso rückgängig machen die Stiftkategorie nicht zur Standardfarbanpassungsmatrix, sondern die Stiftkategorie enthält keine Farbanpassungsmatrix.

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