Interface IXpsOMGradientStop (xpsobjectmodel.h)

Representa uma única cor e local dentro de um gradiente.

Herança

A interface IXpsOMGradientStop herda da interface IUnknown . IXpsOMGradientStop também tem estes tipos de membros:

Métodos

A interface IXpsOMGradientStop tem esses métodos.

IXpsOMGradientStop::Clone Faz uma cópia profunda da interface IXpsOMGradientStop.
IXpsOMGradientStop::GetColor Obtém o valor de cor e o perfil de cor da parada de gradiente.
IXpsOMGradientStop::GetOffset Obtém o valor de deslocamento da parada de gradiente.
IXpsOMGradientStop::GetOwner Obtém um ponteiro para a interface IXpsOMGradientBrush que contém a parada de gradiente.
IXpsOMGradientStop::SetColor Define o valor de cor e o perfil de cor da parada de gradiente.
IXpsOMGradientStop::SetOffset Define o local de deslocamento da parada de gradiente.

Comentários

Uma parada de gradiente é uma cor específica definida para um local dentro da região do gradiente. A cor do gradiente muda entre as paradas de gradiente do gradiente. A área e o local absoluto do gradiente são definidos pela interface de gradiente. O deslocamento é um local relativo dentro da região do gradiente e é medido entre 0,0 e 1,0. Um deslocamento de 0,0 é o início do gradiente e 1,0 é o final. As paradas de gradiente podem ser definidas para qualquer deslocamento dentro do intervalo, incluindo os pontos finais. Essa interface descreve uma e apenas uma parada em um gradiente.

O caminho do gradiente é a linha reta que conecta o ponto inicial e o ponto final de um gradiente linear. A região de gradiente de um gradiente linear consiste na área entre o ponto inicial e o ponto final, incluindo esses pontos, e se estende em ambas as direções em um ângulo reto 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 um local específico ao longo do caminho do gradiente; a cor é interpolada ao longo do caminho do gradiente entre as paradas de gradiente. No exemplo a seguir, a região do gradiente preenche a imagem, portanto, não há nenhuma área de propagação.

Para paradas de gradiente usadas em pincéis de gradiente linear, o valor de deslocamento de 0,0 corresponde ao ponto inicial do caminho do gradiente e o valor de deslocamento de 1,0 corresponde ao ponto final. Para determinar o local de uma parada de gradiente entre esses dois pontos, os valores de deslocamento intermediários são interpolados entre eles. A ilustração a seguir mostra duas paradas de gradiente intermediárias, uma em um deslocamento de 0,25 e outra em 0,75.

Para paradas de gradiente usadas em pincéis radiais-gradientes, o valor de deslocamento de 0,0 corresponde ao local de origem do gradiente e o valor de deslocamento de 1,0 corresponde à circunferência da elipse que vincula o gradiente. Deslocamentos entre 0,0 e 1,0 definem uma elipse interpolada entre a origem do gradiente e a elipse delimitadora. A ilustração a seguir tem uma parada de gradiente intermediária em um deslocamento de 0,50 (gradiente parada 1). O gradiente está usando o método XPS_SPREAD_METHOD_REFLECT spread para preencher o espaço fora da região do gradiente.

Os cálculos usados para renderizar um gradiente são descritos na Especificação de Papel XML.

O exemplo de código a seguir ilustra como criar uma instância dessa interface.

IXpsOMGradientStop    *newInterface;
// The following values are defined outside of 
// this example.
//  XPS_COLOR                    color;
//  IXpsOMColorProfileResource    *colorProfile;
//  FLOAT                        offset;

// 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->CreateGradientStop (
        &color,
        colorProfile,
        offset,
        &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 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

IXpsOMObjectFactory::CreateGradientStop

Interfaces

Especificação de Papel XML