Interface IXpsOMRadialGradientBrush (xpsobjectmodel.h)

Article
12/22/2023

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

Partager via