ImageAttributes::ClearThreshold-Methode (gdiplusimageattributes.h)
Die ImageAttributes::ClearThreshold-Methode löscht den Schwellenwert für eine angegebene Kategorie.
Syntax
Status ClearThreshold(
[in, optional] ColorAdjustType type
);
Parameter
[in, optional] type
Typ: ColorAdjustType
Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die der Schwellenwert 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
Der Schwellenwert ist ein Wert von 0 bis 1, der einen Cutoff-Punkt für jede Farbkomponente angibt. Angenommen, der Schwellenwert ist auf 0,7 festgelegt, und angenommen, Sie rendern eine Farbe, deren rote, grüne und blaue Komponenten 230, 50 und 220 sind. Die rote Komponente 230 ist größer als 0,7×255, sodass die rote Komponente in 255 (volle Intensität) geändert wird. Die grüne Komponente 50 ist kleiner als 0,7×255, sodass die grüne Komponente in 0 geändert wird. Die blaue Komponente 220 ist größer als 0,7×255, sodass die blaue Komponente in 255 geändert wird.
Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Schwellenwert für die Standardkategorie, einen anderen Schwellenwert für die Bitmapkategorie und dennoch einen anderen Schwellenwert 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 einen Schwellenwert und einen Gammawert für die Standardkategorie an. Wenn Sie den Schwellenwert für die Stiftkategorie festlegen, indem Sie ImageAttributes::SetThreshold aufrufen, gilt der Standardschwellenwert nicht für Stifte. Wenn Sie den Stiftschwellenwert später durch Aufrufen von ImageAttributes::ClearThreshold löschen, wird die Stiftkategorie nicht auf den Standardschwellenwert rückgängig machen, sondern die Stiftkategorie hat keinen Schwellenwert. 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 |