Interface IXpsOMGradientBrush (xpsobjectmodel.h)

Cette interface décrit un dégradé composé de points de dégradé. Les classes qui héritent d’IXpsOMGradientBrush spécifient différentes façons d’interpréter les arrêts de dégradé.

IXpsOMGradientBrush est l’interface de base des interfaces IXpsOMLinearGradientBrush et IXpsOMRadialGradientBrush .

Héritage

L’interface IXpsOMGradientBrush hérite d’IXpsOMBrush. IXpsOMGradientBrush a également les types de membres suivants :

Méthodes

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

IXpsOMGradientBrush ::GetColorInterpolationMode Obtient la fonction gamma à utiliser pour l’interpolation des couleurs.
IXpsOMGradientBrush ::GetGradientStops Obtient un pointeur vers une interface IXpsOMGradientStopCollection qui contient la collection d’interfaces IXpsOMGradientStop qui définissent le dégradé.
IXpsOMGradientBrush ::GetSpreadMethod Obtient la valeur XPS_SPREAD_METHOD, qui décrit comment la zone en dehors de la région de dégradé sera affichée.
IXpsOMGradientBrush ::GetTransform Obtient un pointeur vers l’interface IXpsOMMatrixTransform qui contient la transformation de matrice résolue pour le pinceau. (IXpsOMGradientBrush.GetTransform)
IXpsOMGradientBrush ::GetTransformLocal Obtient un pointeur vers l’interface IXpsOMMatrixTransform qui contient la transformation de matrice locale, non partagée et résolue pour le pinceau.
IXpsOMGradientBrush ::GetTransformLookup Obtient le nom de la clé de recherche de l’interface de transformation de matrice partagée qui doit être utilisée pour le pinceau.
IXpsOMGradientBrush ::SetColorInterpolationMode Définit la valeur XPS_COLOR_INTERPOLATION, qui décrit la fonction gamma à utiliser pour l’interpolation des couleurs.
IXpsOMGradientBrush ::SetSpreadMethod Définit la valeur XPS_SPREAD_METHOD, qui décrit la façon dont la zone située en dehors de la région de dégradé doit être affichée.
IXpsOMGradientBrush ::SetTransformLocal Définit le pointeur d’interface IXpsOMMatrixTransform vers une transformation de matrice locale et non partagée qui doit être utilisée pour le pinceau.
IXpsOMGradientBrush ::SetTransformLookup Définit le nom de la clé de recherche d’une transformation de matrice partagée qui doit être utilisée pour le pinceau.

Remarques

Les méthodes de cette interface définissent les paramètres de base d’un dégradé. Le type de dégradé, qui peut être linéaire ou radial, détermine la façon dont ces paramètres sont appliqués.

Comme indiqué dans la figure qui suit, les points de début et de fin d’un dégradé linéaire marquent les points de fin du chemin de dégradé. Le chemin de dégradé est la ligne droite qui relie les points de début et de fin. La région de dégradé d’un dégradé linéaire se compose de la zone entre les points de début et de fin, y compris ces points, et s’étend dans les deux directions à un angle droit par rapport au chemin de dégradé. La zone de propagation est la zone située en dehors de la région de dégradé.

Les arrêts de dégradé définissent la couleur à des emplacements spécifiques le long du chemin de dégradé ; la couleur est interpolée le long du chemin de dégradé entre les arrêts de dégradé, comme illustré dans l’illustration suivante.

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é est une ligne radiale qui balaye l’ensemble de la région de dégradé depuis l’origine du dégradé jusqu’à l’ellipse qui limite la région de dégradé. Dans l’illustration suivante, le chemin de dégradé n’est pas affiché. La méthode spread décrit la façon dont la zone de propagation est remplie. L’implémentation de la méthode spread dépend du type de dégradé (linéaire ou radial). L’illustration suivante montre plusieurs exemples de la façon dont la zone étendue peut être remplie. Pour plus d’informations sur les différentes méthodes de propagation, consultez XPS_SPREAD_METHOD. La transformation détermine la façon dont le dégradé résultant est transformé. La partie visible du dégradé qui est finalement rendue dans l’image est déterminée par le chemin, le trait ou le glyphe qui utilise le pinceau dégradé.

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

IXpsOMBrush

IXpsOMLinearGradientBrush

IXpsOMRadialGradientBrush

Interfaces

XML Paper Specification