Interface ID2D1LinearGradientBrush (d2d1.h)

  • Article

Peint une zone avec un dégradé linéaire.

Héritage

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

Méthodes

L’interface ID2D1LinearGradientBrush contient ces méthodes.

 
ID2D1LinearGradientBrush::GetEndPoint

Récupère les coordonnées de fin du dégradé linéaire.
ID2D1LinearGradientBrush::GetGradientStopCollection

Récupère l’ID2D1GradientStopCollection associé à ce pinceau de dégradé linéaire.
ID2D1LinearGradientBrush::GetStartPoint

Récupère les coordonnées de départ du dégradé linéaire.
ID2D1LinearGradientBrush::SetEndPoint

Définit les coordonnées de fin du dégradé linéaire dans l’espace de coordonnées du pinceau.
ID2D1LinearGradientBrush::SetStartPoint

Définit les coordonnées de départ du dégradé linéaire dans l’espace de coordonnées du pinceau.

Remarques

Un objet ID2D1LinearGradientBrush peint une zone avec un dégradé linéaire le long d’une ligne entre le point de début du pinceau et le point de fin. Le dégradé, défini par le pinceau ID2D1GradientStopCollection, est extrudé perpendiculaire à cette ligne, puis transformé par une transformation de pinceau (si spécifié).

Le point de début et le point de fin sont décrits dans l’espace de pinceau et sont mappés à la cible de rendu lorsque le pinceau est utilisé. Notez que les coordonnées de début et de fin sont absolues et non relatives à la taille cible de rendu. Une valeur de (0, 0) correspond au coin supérieur gauche de la cible de rendu, tandis qu’une valeur de (1, 1) correspond à une diagonale d’un pixel par rapport à (0, 0). S’il existe une transformation de pinceau sans identité ou une transformation cible de rendu, le point de début et le point de fin du pinceau sont également transformés.

Il est possible de spécifier un axe de dégradé qui ne remplit pas complètement la zone en cours de peinture. Dans ce cas, le D2D1_EXTEND_MODE, spécifié par id2D1GradientStopCollection, détermine la façon dont la zone restante est peinte.

Création d’objets ID2D1LinearGradientBrush

Pour créer un pinceau de dégradé linéaire, utilisez la méthode ID2D1RenderTarget::CreateLinearGradientBrush de la cible de rendu sur laquelle le pinceau sera utilisé. Le pinceau ne peut être utilisé qu’avec la cible de rendu qui l’a créé ou avec les cibles compatibles pour cette cible de rendu.

Un pinceau de dégradé linéaire est une ressource dépendante de l’appareil : votre application doit créer des pinceaux de dégradé linéaire après avoir initialisé la cible de rendu avec laquelle les pinceaux seront utilisés, et recréer les pinceaux chaque fois que la cible de rendu doit être recréée. (Pour plus d’informations sur les ressources, consultez Vue d’ensemble des ressources.)

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 d2d1.h

Voir aussi

ID2D1Brush