Interface IXpsOMLinearGradientBrush (xpsobjectmodel.h)
Especifica um gradiente linear, que é o gradiente de cor ao longo de um vetor.
Herança
A interface IXpsOMLinearGradientBrush herda de IXpsOMGradientBrush. IXpsOMLinearGradientBrush também tem estes tipos de membros:
Métodos
A interface IXpsOMLinearGradientBrush tem esses métodos.
| IXpsOMLinearGradientBrush::Clone Faz uma cópia profunda da interface. (IXpsOMLinearGradientBrush.Clone) |
| IXpsOMLinearGradientBrush::GetEndPoint Obtém o ponto final do gradiente. |
| IXpsOMLinearGradientBrush::GetStartPoint Obtém o ponto inicial do gradiente. |
| IXpsOMLinearGradientBrush::SetEndPoint Define o ponto final do gradiente. |
| IXpsOMLinearGradientBrush::SetStartPoint Define o ponto inicial do gradiente. |
Comentários
Na ilustração a seguir, os pontos inicial e final de um gradiente linear também são os pontos inicial e final do caminho do gradiente, que é a linha reta que conecta esses pontos.
A região de gradiente de um gradiente linear é a área entre e incluindo os pontos inicial e final e estendendo-se em ambas as direções em um ângulo reto para o caminho do gradiente. A área de propagação é a área da geometria que fica fora da região do gradiente.
As paradas de gradiente são usadas para definir a cor em locais específicos ao longo do caminho do gradiente. Na ilustração, a parada de gradiente 0 está localizada no ponto inicial do caminho do gradiente e a parada de gradiente 1 está no ponto final. O método XPS_SPREAD_METHOD_PAD spread é usado para preencher a área de distribuição.
O exemplo de código a seguir ilustra como criar uma instância dessa interface.
IXpsOMLinearGradientBrush *newInterface;
// The following values are defined outside of
// this example.
// IXpsOMGradientStop *gradStop1, *gradStop2;
// XPS_POINT startPoint, endPoint;
// Note the implicit requirement that CoInitializeEx
// has previously been called from this thread.
hr = CoCreateInstance(
__uuidof(XpsOMObjectFactory),
NULL,
CLSCTX_INPROC_SERVER,
_uuidof(IXpsOMObjectFactory),
reinterpret_cast<LPVOID*>(&xpsFactory)
);
if (SUCCEEDED(hr))
{
hr = xpsFactory->CreateLinearGradientBrush (
gradStop1,
gradStop2,
&startPoint,
&endPoint,
&newInterface);
if (SUCCEEDED(hr))
{
// use newInterface
newInterface->Release();
}
xpsFactory->Release();
}
else
{
// evaluate HRESULT error returned in hr
}
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 Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsobjectmodel.h |