Cette documentation est archivée et n’est pas conservée.

LinearGradientBrush.EndPoint, propriété

Mise à jour : novembre 2007

Obtient ou définit les coordonnées finales à deux dimensions du dégradé linéaire. Il s'agit d'une propriété de dépendance.

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation

public Point EndPoint { get; set; }
/** @property */
public Point get_EndPoint()
/** @property */
public  void set_EndPoint(Point value)

public function get EndPoint () : Point
public function set EndPoint (value : Point)
<object>
  <object.EndPoint>
    <Point .../>
  </object.EndPoint>
</object>
<object EndPoint="Point" .../>

Valeur de propriété

Type : System.Windows.Point

Les coordonnées finales à deux dimensions du dégradé linéaire. La valeur par défaut est (1,1).

Champ d'identificateur

EndPointProperty

Propriétés de métadonnées ayant la valeur true

Aucune

Un LinearGradientBrush peint un dégradé le long d'une ligne. Les points de départ et de terminaison de la ligne sont définis par les propriétés StartPoint et EndPoint du LinearGradientBrush.

Le dégradé linéaire par défaut est en diagonale. Le StartPoint d'un dégradé linéaire est (0,0) par défaut, l'angle supérieur gauche de la zone qui est remplie, et son EndPoint est (1,1), le coin inférieur droit de la zone qui est remplie. Les couleurs du dégradé obtenu sont interpolées le long du tracé diagonal.

L'image suivante montre un dégradé en diagonale. La ligne noire a été ajoutée pour mettre en surbrillance le chemin d'interpolation du dégradé du point de départ au point de terminaison.

Dégradé linéaire en diagonale

Axe du dégradé pour un dégradé linéaire en diagonale

Spécifier des valeurs relatives ou absolues

Remarquez que la propriété MappingMode d'un LinearGradientBrush détermine si son EndPoint est interprété comme une valeur relative ou absolue. Un MappingMode de RelativeToBoundingBox spécifie que la valeur EndPoint est relative à la taille de la zone peinte. Un MappingMode de Absolute spécifie que la valeur EndPoint est exprimée en pixels indépendants du périphérique. Par défaut, le MappingMode a la valeur RelativeToBoundingBox, faisant du EndPoint une valeur relative.

Cet exemple indique comment utiliser la classe LinearGradientBrush pour peindre une zone avec un dégradé linéaire. Dans l'exemple suivant, le Fill d'un Rectangle est peint avec un dégradé linéaire diagonal qui passe du jaune au rouge au bleu au citron vert.

<!-- This rectangle is painted with a diagonal linear gradient. -->
<Rectangle Width="200" Height="100">
  <Rectangle.Fill>
    <LinearGradientBrush StartPoint="0,0" EndPoint="1,1">
      <GradientStop Color="Yellow" Offset="0.0" />
      <GradientStop Color="Red" Offset="0.25" />
      <GradientStop Color="Blue" Offset="0.75" />
      <GradientStop Color="LimeGreen" Offset="1.0" />
    </LinearGradientBrush>
  </Rectangle.Fill>
</Rectangle>


Rectangle diagonalFillRectangle = new Rectangle();
diagonalFillRectangle.Width = 200;
diagonalFillRectangle.Height = 100;

// Create a diagonal linear gradient with four stops.   
LinearGradientBrush myLinearGradientBrush =
    new LinearGradientBrush();
myLinearGradientBrush.StartPoint = new Point(0,0);
myLinearGradientBrush.EndPoint = new Point(1,1);
myLinearGradientBrush.GradientStops.Add(
    new GradientStop(Colors.Yellow, 0.0));
myLinearGradientBrush.GradientStops.Add(
    new GradientStop(Colors.Red, 0.25));                
myLinearGradientBrush.GradientStops.Add(
    new GradientStop(Colors.Blue, 0.75));        
myLinearGradientBrush.GradientStops.Add(
    new GradientStop(Colors.LimeGreen, 1.0));

// Use the brush to paint the rectangle.
diagonalFillRectangle.Fill = myLinearGradientBrush;


L'illustration suivante montre le dégradé créé dans l'exemple précédent.

Dégradé linéaire en diagonale

Pour créer un dégradé linéaire horizontal, remplacez StartPoint et EndPoint de LinearGradientBrush par les valeurs (0,0.5) et (1,0.5). Dans l'exemple suivant, un Rectangle est peint avec un dégradé linéaire horizontal.

<!-- This rectangle is painted with a horizontal linear gradient. -->
<Rectangle Width="200" Height="100">
  <Rectangle.Fill>
    <LinearGradientBrush StartPoint="0,0.5" EndPoint="1,0.5">
      <GradientStop Color="Yellow" Offset="0.0" />
      <GradientStop Color="Red" Offset="0.25" />
      <GradientStop Color="Blue" Offset="0.75" />
      <GradientStop Color="LimeGreen" Offset="1.0" />
    </LinearGradientBrush>
  </Rectangle.Fill>
</Rectangle>


Rectangle horizontalFillRectangle = new Rectangle();
horizontalFillRectangle.Width = 200;
horizontalFillRectangle.Height = 100;

// Create a horizontal linear gradient with four stops.   
LinearGradientBrush myHorizontalGradient =
    new LinearGradientBrush();
myHorizontalGradient.StartPoint = new Point(0,0.5);
myHorizontalGradient.EndPoint = new Point(1,0.5);
myHorizontalGradient.GradientStops.Add(
    new GradientStop(Colors.Yellow, 0.0));
myHorizontalGradient.GradientStops.Add(
    new GradientStop(Colors.Red, 0.25));                
myHorizontalGradient.GradientStops.Add(
    new GradientStop(Colors.Blue, 0.75));        
myHorizontalGradient.GradientStops.Add(
    new GradientStop(Colors.LimeGreen, 1.0));

// Use the brush to paint the rectangle.
horizontalFillRectangle.Fill = myHorizontalGradient; 



L'illustration suivante montre le dégradé créé dans l'exemple précédent.

Dégradé linéaire horizontal

Pour créer un dégradé linéaire vertical, remplacez StartPoint et EndPoint de LinearGradientBrush par les valeurs (0.5,0) et (0.5,1). Dans l'exemple suivant, un Rectangle est peint avec un dégradé linéaire vertical.

<!-- This rectangle is painted with a vertical gradient. -->
<Rectangle Width="200" Height="100">
  <Rectangle.Fill>
    <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
      <GradientStop Color="Yellow" Offset="0.0" />
      <GradientStop Color="Red" Offset="0.25" />
      <GradientStop Color="Blue" Offset="0.75" />
      <GradientStop Color="LimeGreen" Offset="1.0" />
    </LinearGradientBrush>
  </Rectangle.Fill>
</Rectangle>


Rectangle verticalFillRectangle = new Rectangle();
verticalFillRectangle.Width = 200;
verticalFillRectangle.Height = 100;

// Create a vertical linear gradient with four stops.   
LinearGradientBrush myVerticalGradient =
    new LinearGradientBrush();
myVerticalGradient.StartPoint = new Point(0.5,0);
myVerticalGradient.EndPoint = new Point(0.5,1);
myVerticalGradient.GradientStops.Add(
    new GradientStop(Colors.Yellow, 0.0));
myVerticalGradient.GradientStops.Add(
    new GradientStop(Colors.Red, 0.25));                
myVerticalGradient.GradientStops.Add(
    new GradientStop(Colors.Blue, 0.75));        
myVerticalGradient.GradientStops.Add(
    new GradientStop(Colors.LimeGreen, 1.0));

// Use the brush to paint the rectangle.
verticalFillRectangle.Fill = myVerticalGradient;  


L'illustration suivante montre le dégradé créé dans l'exemple précédent.

Dégradé linéaire vertical
Remarque :

Les exemples de cette rubrique utilisent le système de coordonnées par défaut pour définir les points de départ et de terminaison. Le système de coordonnées par défaut est relatif par rapport à une zone englobante : 0 indique 0 % de la zone englobante et 1 indique 100 % de la zone englobante. Vous pouvez modifier ce système de coordonnées en affectant la valeur BrushMappingMode.Absolute à la propriété MappingMode. Un système de coordonnées absolues n'est pas relatif par rapport à une zone englobante. Les valeurs sont interprétées directement dans l'espace local.

Pour plus d'exemples, consultez Pinceaux, exemple. Pour plus d'informations sur les dégradés et sur les autres types de pinceaux, consultez Vue d'ensemble de la peinture avec des couleurs unies ou des dégradés.

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0
Afficher: