ImageAttributes::ClearRemapTable-Methode (gdiplusimageattributes.h)

Artikel
02/26/2024

Die ImageAttributes::ClearRemapTable-Methode löscht die Color-Remap-Tabelle für eine angegebene Kategorie.

Syntax

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

Parameter

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Neuzuordnungstabelle 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 eine Umzuordnungstabelle für die Standardkategorie, eine andere Umzuordnungstabelle für die Bitmapkategorie und weiterhin eine andere Umzuordnungstabelle 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 Neuzuordnungstabelle und einen Gammawert für die Standardkategorie an. Wenn Sie die Umzuordnungstabelle für die Stiftkategorie festlegen, indem Sie ImageAttributes::SetRemapTable aufrufen, gilt die Standardtabelle für die Neuzuordnung nicht für Stifte. Wenn Sie die Stiftremaptabelle später löschen, indem Sie ImageAttributes::ClearRemapTable aufrufen, rückgängig machen die Stiftkategorie nicht zur Standardtabelle für die Neuzuordnung, sondern die Stiftkategorie verfügt über keine Neuzuordnungstabelle. Ebenso rückgängig machen die Stiftkategorie nicht auf den Gammastandardwert, sondern die Stiftkategorie hat keinen Gammawert.

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