Método IXpsOMGradientStop::SetColor (xpsobjectmodel.h)
Define o valor de cor e o perfil de cor da parada de gradiente.
Sintaxe
HRESULT SetColor(
[in] const XPS_COLOR *color,
[in] IXpsOMColorProfileResource *colorProfile
);
Parâmetros
[in] color
O valor de cor a ser definido na parada de gradiente.
Se o valor do campo colorType na estrutura XPS_COLOR passada nesse parâmetro for XPS_COLOR_TYPE_CONTEXT, um perfil de cor válido deverá ser fornecido no parâmetro colorProfile .
[in] colorProfile
O perfil de cor a ser usado com cor.
Um perfil de cor é necessário quando o valor do campo colorType na estrutura XPS_COLOR passada no parâmetro de cor é XPS_COLOR_TYPE_CONTEXT. Se o valor do campo colorType não for XPS_COLOR_TYPE_CONTEXT, esse parâmetro deverá ser definido como NULL.
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, 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 |
|---|---|
|
O método foi bem-sucedido. |
|
color é NULL. |
|
colorProfile é NULL quando um perfil de cor era esperado. Um perfil de cor é necessário quando o tipo de cor é XPS_COLOR_TYPE_CONTEXT. |
|
colorProfile não aponta para uma implementação de interface reconhecida. Não há suporte para a implementação personalizada de interfaces da API de Documento XPS. |
|
colorProfile continha um perfil de cor quando um não era esperado. Um perfil de cor só é permitido quando o tipo de cor é XPS_COLOR_TYPE_CONTEXT. |
Comentários
Um perfil de cor só é necessário quando o tipo de cor é XPS_COLOR_TYPE_CONTEXT.
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 Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsobjectmodel.h |