ImageAttributes::ClearThreshold-Methode (gdiplusimageattributes.h)

Artikel
08/24/2023

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