Interfaccia IXpsOMRadialGradientBrush (xpsobjectmodel.h)

Specifica una sfumatura radiale.

Ereditarietà

L'interfaccia IXpsOMRadialGradientBrush eredita da IXpsOMGradientBrush. IXpsOMRadialGradientBrush include anche questi tipi di membri:

Metodi

L'interfaccia IXpsOMRadialGradientBrush include questi metodi.

IXpsOMRadialGradientBrush::Clone Crea una copia completa dell'interfaccia. (IXpsOMRadialGradientBrush.Clone)
IXpsOMRadialGradientBrush::GetCenter Ottiene il punto centrale dell'ellisse dell'area del gradiente radiale.
IXpsOMRadialGradientBrush::GetGradientOrigin Ottiene il punto di origine della sfumatura radiale.
IXpsOMRadialGradientBrush::GetRadiiSizes Ottiene le dimensioni dei raggi che definiscono l'ellisse dell'area del gradiente radiale.
IXpsOMRadialGradientBrush::SetCenter Imposta il punto centrale dell'ellisse dell'area del gradiente radiale.
IXpsOMRadialGradientBrush::SetGradientOrigin Imposta il punto di origine della sfumatura radiale.
IXpsOMRadialGradientBrush::SetRadiiSizes Imposta le dimensioni dei raggi che definiscono l'ellisse dell'area del gradiente radiale.

Commenti

Come illustrato nella figura seguente, l'area sfumatura di una sfumatura radiale è l'area racchiusa dall'ellisse descritta dal punto centrale e dalla x e yradii che si estendono dal punto centrale. L'area di diffusione è l'area all'esterno di quell'ellisse. Il percorso sfumato (non visualizzato) è una linea radiale disegnata tra l'origine della sfumatura e l'ellisse che delimita l'area del gradiente.

L'esempio di codice seguente illustra come creare un'istanza di questa interfaccia.

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
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h

Vedi anche

IXpsOMGradientBrush

IXpsOMLinearGradientBrush

IXpsOMObjectFactory::CreateRadialGradientBrush

Interfacce

XML Paper Specification