ImageAttributes::Reset-Methode (gdiplusimageattributes.h)

Artikel
08/24/2023

Die ImageAttributes::Reset-Methode löscht alle Farb- und Graustufenanpassungseinstellungen für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Farbanpassung zurückgesetzt 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 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. Sie können die Standardeinstellungen für diese Kategorie wiederherstellen, indem Sie ImageAttributes::Reset aufrufen. Angenommen, Sie geben einen Gammawert 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 ColorAdjustTypePen später an die ImageAttributes::Reset-Methode übergeben, rückgängig machen die Stiftkategorie auf den Standard-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