Freigeben über


IXpsOMGradientStopCollection::RemoveAt-Methode (xpsobjectmodel.h)

Entfernt einen IXpsOMGradientStop-Schnittstellenzeiger von einem angegebenen Speicherort in der Auflistung und gibt diesen frei.

Syntax

HRESULT RemoveAt(
  [in] UINT32 index
);

Parameter

[in] index

Der nullbasierte Index in der Auflistung, aus dem ein IXpsOMGradientStop-Schnittstellenzeiger entfernt und freigegeben werden soll.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, 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_INVALIDARG
Die Farbverlaufsstoppauflistung weist nur zwei Stopps auf. Eine Farbverlaufsstoppauflistung muss mindestens zwei Farbverlaufsstopps aufweisen, und das Entfernen des angegebenen Farbverlaufsstopps würde weniger als zwei Farbverlaufsstopps in der Auflistung hinterlassen.

Hinweise

Diese Methode gibt die IXpsOMGradientStop-Schnittstelle frei, auf die der Zeiger an der vom Index angegebenen Position verweist. Nach dem Freigeben der Schnittstelle komprimiert diese Methode die Auflistung, indem der Index jedes Zeigers, der auf den Index folgt, um 1 reduziert wird.

Weitere Informationen zu den Auflistungsmethoden finden Sie unter Arbeiten mit XPS OM-Sammlungsschnittstellen.

Anforderungen

Anforderung Wert
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

IXpsOMGradientStop

IXpsOMGradientStopCollection

Arbeiten mit XPS OM-Sammlungsschnittstellen

XML Paper Specification

XPS-Dokumentfehler