structure D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Contient le point de départ et le point de terminaison de l’axe de dégradé d’un OBJET ID2D1LinearGradientBrush.

Syntaxe

typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;

Membres

startPoint

Type : D2D1_POINT_2F

Dans l’espace de coordonnées du pinceau, point de départ de l’axe du dégradé.

endPoint

Type : D2D1_POINT_2F

Dans l’espace de coordonnées du pinceau, point de terminaison de l’axe de dégradé.

Remarques

Utilisez cette méthode lors de la création de nouveaux objets ID2D1LinearGradientBrush avec la méthode CreateLinearGradientBrush . Pour plus de commodité, Direct2D fournit la fonction d’assistance D2D1 ::LinearGradientBrushProperties pour la création de nouvelles structures D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES .

L’illustration suivante montre comment un dégradé linéaire change à mesure que vous modifiez ses points de début et de fin. Pour le premier dégradé, le point de début est défini sur (0,0) et le point de fin sur (150, 50) ; cela crée un dégradé diagonal qui commence dans le coin supérieur gauche et s’étend jusqu’au coin inférieur droit de la zone en cours de peinture. Lorsque vous définissez le point de début sur (0, 25) et le point de fin sur (150, 25), un dégradé horizontal est créé. De même, définir le point de début sur (75, 0) et le point de fin sur (75, 50) crée un dégradé vertical. Le fait de définir le point de début sur (0, 50) et le point de fin sur (150, 0) crée un dégradé diagonal qui commence dans le coin inférieur gauche et s’étend jusqu’au coin supérieur droit de la zone en cours de peinture.

Exemples

L’exemple suivant utilise la méthode CreateLinearGradientBrush pour créer un ID2D1LinearGradientBrush (m_pLinearGradientBrush). Il utilise la méthode d’assistance D2D1 ::LinearGradientBrushProperties pour créer une structure D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES qui contient un point de début (0, 0) et un point de fin de (150, 150) et la transmet à la méthode CreateLinearGradientBrush .

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

Pour plus d’informations sur la création et l’utilisation de pinceaux de dégradé linéaire, consultez la rubrique Création d’un pinceau de dégradé linéaire et Vue d’ensemble des pinceaux.

Configuration requise

Voir aussi

Vue d’ensemble des pinceaux

Comment créer un pinceau de dégradé linéaire