ID2D1LinearGradientBrush-Schnittstelle (d2d1.h)

  • Artikel

Zeichnet einen Bereich mit einem linearen Farbverlauf.

Vererbung

Die ID2D1LinearGradientBrush-Schnittstelle erbt von ID2D1Brush. ID2D1LinearGradientBrush verfügt auch über folgende Membertypen:

Methoden

Die ID2D1LinearGradientBrush-Schnittstelle verfügt über diese Methoden.

 
ID2D1LinearGradientBrush::GetEndPoint

Ruft die Endkoordinaten des linearen Farbverlaufs ab.
ID2D1LinearGradientBrush::GetGradientStopCollection

Ruft die ID2D1GradientStopCollection ab, die diesem linearen Farbverlaufspinsel zugeordnet ist.
ID2D1LinearGradientBrush::GetStartPoint

Ruft die Startkoordinaten des linearen Farbverlaufs ab.
ID2D1LinearGradientBrush::SetEndPoint

Legt die Endkoordinaten des linearen Farbverlaufs im Koordinatenraum des Pinsels fest.
ID2D1LinearGradientBrush::SetStartPoint

Legt die Startkoordinaten des linearen Farbverlaufs im Koordinatenraum des Pinsels fest.

Hinweise

Ein ID2D1LinearGradientBrush zeichnet einen Bereich mit einem linearen Farbverlauf entlang einer Linie zwischen Pinselstartpunkt und Endpunkt. Der durch den Pinsel ID2D1GradientStopCollection definierte Farbverlauf wird senkrecht zu dieser Linie extrudiert und dann durch eine Pinseltransformation transformiert (sofern angegeben).

Start- und Endpunkt werden im Pinselraum beschrieben und dem Renderziel zugeordnet, wenn der Pinsel verwendet wird. Beachten Sie, dass die Anfangs- und Endkoordinaten absolut und nicht relativ zur Renderzielgröße sind. Ein Wert von (0, 0) wird der oberen linken Ecke des Renderziels zugeordnet, während ein Wert von (1, 1) einem Pixel diagonal von (0, 0) zugeordnet ist. Wenn eine Nichtidentity-Pinseltransformation oder eine Renderzieltransformation vorhanden ist, werden auch der Start- und Endpunkt des Pinsels transformiert.

Es ist möglich, eine Farbverlaufsachse anzugeben, die den gezeichneten Bereich nicht vollständig ausfüllt. In diesem Fall bestimmt der D2D1_EXTEND_MODE, der durch id2D1GradientStopCollection angegeben wird, wie der verbleibende Bereich gezeichnet wird.

Erstellen von ID2D1LinearGradientBrush-Objekten

Verwenden Sie zum Erstellen eines linearen Farbverlaufspinsels die ID2D1RenderTarget::CreateLinearGradientBrush-Methode des Renderziels, für das der Pinsel verwendet wird. Der Pinsel kann nur mit dem Renderziel verwendet werden, von dem er erstellt wurde, oder mit den kompatiblen Zielen für dieses Renderziel.

Ein linearer Farbverlaufspinsel ist eine geräteabhängige Ressource: Ihre Anwendung sollte lineare Farbverlaufspinsel erstellen, nachdem sie das Renderziel initialisiert hat, mit dem die Pinsel verwendet werden sollen, und die Pinsel immer dann neu erstellen, wenn das Renderziel neu erstellt werden muss. (Weitere Informationen zu Ressourcen finden Sie unter Ressourcenübersicht.)

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h

Weitere Informationen

ID2D1Brush