Partager via


Interface IXpsOMRadialGradientBrush (xpsobjectmodel.h)

Spécifie un dégradé radial.

Héritage

L’interface IXpsOMRadialGradientBrush hérite d’IXpsOMGradientBrush. IXpsOMRadialGradientBrush possède également les types de membres suivants :

Méthodes

L’interface IXpsOMRadialGradientBrush possède ces méthodes.

 
IXpsOMRadialGradientBrush ::Clone

Effectue une copie approfondie de l’interface. (IXpsOMRadialGradientBrush.Clone)
IXpsOMRadialGradientBrush ::GetCenter

Obtient le point central de l’ellipse de la région de dégradé radiale.
IXpsOMRadialGradientBrush ::GetGradientOrigin

Obtient le point d’origine du dégradé radial.
IXpsOMRadialGradientBrush ::GetRadiiSizes

Obtient les tailles des rayons qui définissent l’ellipse de la région de dégradé radiale.
IXpsOMRadialGradientBrush ::SetCenter

Définit le point central de l’ellipse de la région de dégradé radiale.
IXpsOMRadialGradientBrush ::SetGradientOrigin

Définit le point d’origine du dégradé radial.
IXpsOMRadialGradientBrush ::SetRadiiSizes

Définit les tailles des rayons qui définissent l’ellipse de la région de dégradé radiale.

Remarques

Comme le montre la figure qui suit, la région de dégradé d’un dégradé radial est la zone entourée par l’ellipse décrite par le point central et les rayons x et y qui s’étendent à partir du point central. La zone de propagation est la zone située à l’extérieur de cette ellipse. Le chemin de dégradé (non affiché) est une ligne radiale qui est dessinée entre l’origine du dégradé et l’ellipse qui limite la région de dégradé.

Figure montrant les termes utilisés dans un dégradé radial L’exemple de code qui suit montre comment créer un instance de cette interface.

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
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête xpsobjectmodel.h

Voir aussi

IXpsOMGradientBrush

IXpsOMLinearGradientBrush

IXpsOMObjectFactory ::CreateRadialGradientBrush

Interfaces

XML Paper Specification