Compartir a través de


Interfaz IXpsOMRadialGradientBrush (xpsobjectmodel.h)

Especifica un degradado radial.

Herencia

La interfaz IXpsOMRadialGradientBrush hereda de IXpsOMGradientBrush. IXpsOMRadialGradientBrush también tiene estos tipos de miembros:

Métodos

La interfaz IXpsOMRadialGradientBrush tiene estos métodos.

 
IXpsOMRadialGradientBrush::Clone

Realiza una copia profunda de la interfaz. (IXpsOMRadialGradientBrush.Clone)
IXpsOMRadialGradientBrush::GetCenter

Obtiene el punto central de la elipse de la región de degradado radial.
IXpsOMRadialGradientBrush::GetGradientOrigin

Obtiene el punto de origen del degradado radial.
IXpsOMRadialGradientBrush::GetRadiiSizes

Obtiene los tamaños de los radios que definen la elipse de la región de degradado radial.
IXpsOMRadialGradientBrush::SetCenter

Establece el punto central de la elipse de la región de degradado radial.
IXpsOMRadialGradientBrush::SetGradientOrigin

Establece el punto de origen del degradado radial.
IXpsOMRadialGradientBrush::SetRadiiSizes

Establece los tamaños de los radios que definen la elipse de la región de degradado radial.

Comentarios

Como se muestra en la ilustración siguiente, la región degradada de un degradado radial es el área entre la elipse descrita por el punto central y los radios x e y que se extienden desde el punto central. El área de propagación es el área fuera de esa elipse. La ruta de degradado (no se muestra) es una línea radial que se dibuja entre el origen del degradado y la elipse que enlaza la región de degradado.

Ilustración que muestra los términos usados en un degradado radial En el ejemplo de código siguiente se muestra cómo crear una instancia de esta interfaz.

IXpsOMRadialGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                centerPoint, gradientOrigin;
//  XPS_SIZE                 radiiSizes;

// 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->CreateRadialGradientBrush (
        gradStop1,
        gradStop2,
        &centerPoint,
        &gradientOrigin,
        &radiiSizes,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado xpsobjectmodel.h

Consulte también

IXpsOMGradientBrush

IXpsOMLinearGradientBrush

IXpsOMObjectFactory::CreateRadialGradientBrush

Interfaces

XML Paper Specification