Método IXpsOMGradientBrush::GetGradientStops (xpsobjectmodel.h)

Obtém um ponteiro para uma interface IXpsOMGradientStopCollection que contém a coleção de interfaces IXpsOMGradientStop que definem o gradiente.

Sintaxe

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

Parâmetros

[out, retval] gradientStops

Um ponteiro para a interface IXpsOMGradientStopCollection que contém a coleção de interfaces IXpsOMGradientStop .

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_POINTER
gradientStops é NULL.

Comentários

As paradas de gradiente, que são descritas no OM XPS por uma interface IXpsOMGradientStop , são usadas para definir a cor em um local específico ao longo de um caminho de gradiente; a cor é interpolada entre as paradas de gradiente. A ilustração a seguir mostra o caminho do gradiente e as paradas de gradiente de um gradiente linear.

Uma figura que mostra os termos usados em um gradiente linear A ilustração a seguir mostra as paradas de gradiente de um gradiente radial. Neste exemplo, a região do gradiente é a área entre as reticências externas e o gradiente radial está usando o método XPS_SPREAD_METHOD_REFLECT spread para preencher o espaço fora da região do gradiente. Uma figura que mostra os termos usados em um gradiente radial

Requisitos

   
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

Confira também

IXpsOMGradientBrush

IXpsOMGradientStop

Especificação de Papel XML

Erros de documento XPS