Freigeben über


IXpsOMGradientBrush::GetGradientStops-Methode (xpsobjectmodel.h)

Ruft einen Zeiger auf eine IXpsOMGradientStopCollection-Schnittstelle ab, die die Auflistung der IXpsOMGradientStop-Schnittstellen enthält, die den Farbverlauf definieren.

Syntax

HRESULT GetGradientStops(
  [out, retval] IXpsOMGradientStopCollection **gradientStops
);

Parameter

[out, retval] gradientStops

Ein Zeiger auf die IXpsOMGradientStopCollection-Schnittstelle , die die Auflistung von IXpsOMGradientStop-Schnittstellen enthält.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode Beschreibung
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
gradientStops ist NULL.

Hinweise

Farbverlaufsstopps, die im XPS OM von einer IXpsOMGradientStop-Schnittstelle beschrieben werden, werden verwendet, um die Farbe an einer bestimmten Stelle entlang eines Farbverlaufspfads zu definieren. Die Farbe wird zwischen den Farbverlaufsstopps interpoliert. Die folgende Abbildung zeigt den Farbverlaufspfad und die Farbverlaufsstopps eines linearen Farbverlaufs.

Abbildung, die die in einem linearen Farbverlauf verwendeten Begriffe zeigt Die folgende Abbildung zeigt die Farbverlaufsstopps eines radialen Farbverlaufs. In diesem Beispiel ist der Farbverlaufsbereich der bereich, der von der äußeren Ellipse eingeschlossen ist, und der radiale Farbverlauf verwendet die XPS_SPREAD_METHOD_REFLECT spread-Methode , um den Raum außerhalb des Farbverlaufsbereichs auszufüllen. Abbildung, die die in einem radialen Farbverlauf verwendeten Begriffe zeigt

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

IXpsOMGradientBrush

IXpsOMGradientStop

XML Paper Specification

XPS-Dokumentfehler