Método IXpsOMGradientStopCollection::RemoveAt (xpsobjectmodel.h)

Artigo
03/05/2024

Remove e libera um ponteiro de interface IXpsOMGradientStop de um local especificado na coleção.

Sintaxe

HRESULT RemoveAt(
  [in] UINT32 index
);

Parâmetros

[in] index

O índice baseado em zero na coleção da qual um ponteiro de interface IXpsOMGradientStop deve ser removido e liberado.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	A coleção de paradas de gradiente tem apenas duas paradas. Uma coleção de parada de gradiente deve ter pelo menos duas paradas de gradiente e remover a parada de gradiente especificada deixaria menos de duas paradas de gradiente na coleção.

Comentários

Esse método libera a interface IXpsOMGradientStop referenciada pelo ponteiro no local especificado pelo índice. Depois de liberar a interface, esse método compacta a coleção reduzindo em 1 o índice de cada ponteiro subsequente ao índice.

Para obter mais informações sobre os métodos de coleção, consulte Trabalhando com interfaces de coleção de OM XPS.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h