Interface IXpsOMLinearGradientBrush (xpsobjectmodel.h)

Article
12/22/2023

Spécifie un dégradé linéaire, qui est le dégradé de couleur le long d’un vecteur.

Héritage

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

Méthodes

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


IXpsOMLinearGradientBrush ::Clone Effectue une copie approfondie de l’interface. (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush ::GetEndPoint Obtient le point de fin du dégradé.
IXpsOMLinearGradientBrush ::GetStartPoint Obtient le point de départ du dégradé.
IXpsOMLinearGradientBrush ::SetEndPoint Définit le point de fin du dégradé.
IXpsOMLinearGradientBrush ::SetStartPoint Définit le point de départ du dégradé.

Remarques

Dans l’illustration qui suit, les points de début et de fin d’un dégradé linéaire sont également les points de début et de fin du chemin de dégradé, qui est la ligne droite qui relie ces points.

La région de dégradé d’un dégradé linéaire est la zone comprise entre et les points de début et de fin et s’étendant dans les deux directions à un angle droit par rapport au chemin de dégradé. La zone de propagation est la zone de la géométrie qui se trouve en dehors de la région de dégradé.

Les points de dégradé sont utilisés pour définir la couleur à des emplacements spécifiques le long du chemin de dégradé. Dans l’illustration, le point de dégradé 0 se trouve au point de départ du chemin de dégradé et le point de dégradé 1 se trouve au point de fin. La méthode d’épandage XPS_SPREAD_METHOD_PAD est utilisée pour remplir la zone d’épandage.

Figure qui montre les termes utilisés dans un dégradé linéaire

L’exemple de code qui suit montre comment créer un instance de cette interface.


IXpsOMLinearGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                startPoint, endPoint;

// 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->CreateLinearGradientBrush (
        gradStop1,
        gradStop2,
        &startPoint,
        &endPoint,
        &newInterface);

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

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

Configuration requise


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

IXpsOMGradientStop

IXpsOMObjectFactory ::CreateLinearGradientBrush

IXpsOMRadialGradientBrush

Interfaces

XML Paper Specification

Partager via