Interface IXpsOMGradientBrush (xpsobjectmodel.h)
Essa interface descreve um gradiente composto por paradas de gradiente. Classes que herdam de IXpsOMGradientBrush especificam diferentes maneiras de interpretar paradas de gradiente.
IXpsOMGradientBrush é a interface base para as interfaces IXpsOMLinearGradientBrush e IXpsOMRadialGradientBrush .
Herança
A interface IXpsOMGradientBrush herda de IXpsOMBrush. IXpsOMGradientBrush também tem estes tipos de membros:
Métodos
A interface IXpsOMGradientBrush tem esses métodos.
| IXpsOMGradientBrush::GetColorInterpolationMode Obtém a função gama a ser usada para interpolação de cores. |
| IXpsOMGradientBrush::GetGradientStops Obtém um ponteiro para uma interface IXpsOMGradientStopCollection que contém a coleção de interfaces IXpsOMGradientStop que definem o gradiente. |
| IXpsOMGradientBrush::GetSpreadMethod Obtém o valor XPS_SPREAD_METHOD, que descreve como a área fora da região do gradiente será renderizada. |
| IXpsOMGradientBrush::GetTransform Obtém um ponteiro para a interface IXpsOMMatrixTransform que contém a transformação de matriz resolvida para o pincel. (IXpsOMGradientBrush.GetTransform) |
| IXpsOMGradientBrush::GetTransformLocal Obtém um ponteiro para a interface IXpsOMMatrixTransform que contém a transformação de matriz local, não compartilhada e resolvida para o pincel. |
| IXpsOMGradientBrush::GetTransformLookup Obtém o nome da chave de pesquisa da interface de transformação de matriz compartilhada que deve ser usada para o pincel. |
| IXpsOMGradientBrush::SetColorInterpolationMode Define o valor XPS_COLOR_INTERPOLATION, que descreve a função gama a ser usada para interpolação de cores. |
| IXpsOMGradientBrush::SetSpreadMethod Define o valor XPS_SPREAD_METHOD, que descreve como a área fora da região de gradiente deve ser renderizada. |
| IXpsOMGradientBrush::SetTransformLocal Define o ponteiro da interface IXpsOMMatrixTransform como uma transformação de matriz local e não personalizada que deve ser usada para o pincel. |
| IXpsOMGradientBrush::SetTransformLookup Define o nome da chave de pesquisa de uma transformação de matriz compartilhada que deve ser usada para o pincel. |
Comentários
Os métodos dessa interface definem os parâmetros básicos de um gradiente. O tipo de gradiente, que pode ser linear ou radial, determina como esses parâmetros são aplicados.
Conforme mostrado na figura a seguir, os pontos inicial e final de um gradiente linear marcam os pontos finais do caminho do gradiente. O caminho do gradiente é a linha reta que conecta os pontos inicial e final. A região de gradiente de um gradiente linear consiste na área entre os pontos inicial e final, incluindo esses pontos, e se estende em ambas as direções em um ângulo direito até o caminho do gradiente. A área de propagação é a área fora da região do gradiente.
As paradas de gradiente definem a cor em locais específicos ao longo do caminho do gradiente; a cor é interpolada ao longo do caminho do gradiente entre as paradas de gradiente, conforme mostrado na ilustração a seguir.
Conforme mostrado na figura a seguir, a região de gradiente de um gradiente radial é a área entre as reticências descritas pelo ponto central e pelos raios x e y que se estendem do ponto central. A área de propagação é a área fora dessa elipse. O caminho do gradiente é uma linha radial que varre toda a região do gradiente da origem do gradiente até a elipse que associa a região do gradiente. Na ilustração a seguir, o caminho do gradiente não é mostrado.
O método spread descreve como a área de propagação é preenchida. A implementação do método spread depende do tipo de gradiente (linear ou radial). A ilustração a seguir mostra vários exemplos de como a área de distribuição pode ser preenchida. Para obter informações sobre diferentes métodos de distribuição, consulte XPS_SPREAD_METHOD.
A transformação determina como o gradiente resultante é transformado. A parte visível do gradiente que é renderizada na imagem é determinada pelo caminho, traço ou glifo que está usando o pincel de gradiente.
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 |