Share via


IXpsOMGradientStopCollection::RemoveAt method

Removes and releases an IXpsOMGradientStop interface pointer from a specified location in the collection.

Syntax

HRESULT RemoveAt(
  [in] UINT32 index
);

Parameters

  • index [in]
    The zero-based index in the collection from which an IXpsOMGradientStop interface pointer is to be removed and released.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For information about XPS document API return values that are not listed in this table, see XPS Document Errors.

Return code Description
S_OK

The method succeeded.

E_INVALIDARG

The gradient stop collection has only two stops. A gradient stop collection must have at least two gradient stops, and removing the specified gradient stop would leave fewer than two gradient stops in the collection.

 

Remarks

This method releases the IXpsOMGradientStop interface referenced by the pointer at the location specified by index. After releasing the interface, this method compacts the collection by reducing by 1 the index of each pointer subsequent to index.

For more information about the collection methods, see Working with XPS OM Collection Interfaces.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Header

Xpsobjectmodel.h

IDL

XpsObjectModel.idl

See also

IXpsOMGradientStopCollection

Working with XPS OM Collection Interfaces

IXpsOMGradientStop

XPS Document Errors

XML Paper Specification