IXpsOMGradientBrush-Schnittstelle (xpsobjectmodel.h)

Diese Schnittstelle beschreibt einen Farbverlauf, der aus Farbverlaufsstopps besteht. Klassen, die von IXpsOMGradientBrush erben, geben verschiedene Möglichkeiten zum Interpretieren von Farbverlaufsstopps an.

IXpsOMGradientBrush ist die Basisschnittstelle für die Schnittstellen IXpsOMLinearGradientBrush und IXpsOMRadialGradientBrush .

Vererbung

Die IXpsOMGradientBrush-Schnittstelle erbt von IXpsOMBrush. IXpsOMGradientBrush verfügt auch über folgende Membertypen:

Methoden

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

IXpsOMGradientBrush::GetColorInterpolationMode Ruft die Gammafunktion ab, die für die Farbinterpolation verwendet werden soll.
IXpsOMGradientBrush::GetGradientStops Ruft einen Zeiger auf eine IXpsOMGradientStopCollection-Schnittstelle ab, die die Auflistung der IXpsOMGradientStop-Schnittstellen enthält, die den Farbverlauf definieren.
IXpsOMGradientBrush::GetSpreadMethod Ruft den XPS_SPREAD_METHOD-Wert ab, der beschreibt, wie der Bereich außerhalb des Farbverlaufsbereichs gerendert wird.
IXpsOMGradientBrush::GetTransform Ruft einen Zeiger auf die IXpsOMMatrixTransform-Schnittstelle ab, die die aufgelöste Matrixtransformation für den Pinsel enthält. (IXpsOMGradientBrush.GetTransform)
IXpsOMGradientBrush::GetTransformLocal Ruft einen Zeiger auf die IXpsOMMatrixTransform-Schnittstelle ab, die die lokale, nicht freigegebene, aufgelöste Matrixtransformation für den Pinsel enthält.
IXpsOMGradientBrush::GetTransformLookup Ruft den Namen des Nachschlageschlüssels der Transformationsschnittstelle der freigegebenen Matrix ab, die für den Pinsel verwendet werden soll.
IXpsOMGradientBrush::SetColorInterpolationMode Legt den XPS_COLOR_INTERPOLATION Wert fest, der die Gammafunktion beschreibt, die für die Farbinterpolation verwendet werden soll.
IXpsOMGradientBrush::SetSpreadMethod Legt den XPS_SPREAD_METHOD Wert fest, der beschreibt, wie der Bereich außerhalb des Farbverlaufsbereichs gerendert werden soll.
IXpsOMGradientBrush::SetTransformLocal Legt den IXpsOMMatrixTransform-Schnittstellenzeiger auf eine lokale, nicht freigegebene Matrixtransformation fest, die für den Pinsel verwendet werden soll.
IXpsOMGradientBrush::SetTransformLookup Legt den Namen des Nachschlageschlüssels einer freigegebenen Matrixtransformation fest, die für den Pinsel verwendet werden soll.

Hinweise

Die Methoden dieser Schnittstelle definieren die grundlegenden Parameter eines Farbverlaufs. Der Farbverlaufstyp, der linear oder radial sein kann, bestimmt, wie diese Parameter angewendet werden.

Wie in der folgenden Abbildung dargestellt, markieren die Anfangs- und Endpunkte eines linearen Farbverlaufs die Endpunkte des Farbverlaufspfads. Der Farbverlaufspfad ist die gerade Linie, die den Start- und Endpunkt verbindet. Der Farbverlaufsbereich eines linearen Farbverlaufs besteht aus dem Bereich zwischen dem Start- und Endpunkt, einschließlich dieser Punkte, und erstreckt sich in beiden Richtungen im rechten Winkel zum Farbverlaufspfad. Der Verteilungsbereich ist der Bereich außerhalb des Farbverlaufsbereichs.

Farbverlaufsstopps definieren die Farbe an bestimmten Stellen entlang des Farbverlaufspfads; Die Farbe wird entlang des Farbverlaufspfads zwischen den Farbverlaufsstopps interpoliert, wie in der folgenden Abbildung dargestellt.

Wie in der folgenden Abbildung dargestellt, ist der Farbverlaufsbereich eines radialen Farbverlaufs der Bereich, der von der Ellipse umschlossen wird, die durch den Mittelpunkt und die x- und y-Radien beschrieben wird, die sich vom Mittelpunkt aus erstrecken. Der Verbreitungsbereich ist der Bereich außerhalb dieser Ellipse. Der Farbverlaufspfad ist eine radiale Linie, die den gesamten Farbverlaufsbereich vom Farbverlaufsursprung bis zur Ellipse umgibt, die den Farbverlaufsbereich begrenzt. In der folgenden Abbildung wird der Farbverlaufspfad nicht angezeigt. Die Spread-Methode beschreibt, wie die Verteilungsfläche gefüllt wird. Die Implementierung der Spread-Methode hängt vom Farbverlaufstyp (linear oder radial) ab. Die folgende Abbildung zeigt mehrere Beispiele dafür, wie der Streubereich gefüllt werden kann. Informationen zu verschiedenen Verteilungsmethoden finden Sie unter XPS_SPREAD_METHOD. Die Transformation bestimmt, wie der resultierende Farbverlauf transformiert wird. Der sichtbare Teil des Farbverlaufs, der letztendlich im Bild gerendert wird, wird durch den Pfad, den Strich oder die Glyphe bestimmt, die den Farbverlaufpinsel verwendet.

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	xpsobjectmodel.h

Weitere Informationen

IXpsOMBrush

IXpsOMLinearGradientBrush

IXpsOMRadialGradientBrush

Schnittstellen

XML Paper Specification