ID2D1CommandSink::Clear-Methode (d2d1_1.h)
Löscht den Zeichnungsbereich auf die angegebene Farbe.
Syntax
HRESULT Clear(
[in, optional] const D2D1_COLOR_F *color
);
Parameter
[in, optional] color
Typ: const D2D1_COLOR_F*
Die Farbe, in die die Befehlssenke gelöscht werden soll.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Die klare Farbe wird durch die derzeit ausgewählten Clip- und Ebenengrenzen eingeschränkt.
Wenn keine Farbe angegeben wird, sollte die Farbe nach Kontext interpretiert werden. Beispiele sind, sind jedoch nicht beschränkt auf:
- Transparentes Schwarz für ein prämultipliziertes Bitmapziel.
- Undurchsichtig schwarz für ein Bitmapziel ignorieren.
- Enthält keinen Inhalt (oder weiß) für eine Druckerseite.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| DLL | D2d1.dll |