GradientBrush.GradientStops, propriété
Mise à jour : novembre 2007
Obtient ou définit les points de dégradé du pinceau.
Assembly : PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation
/** @property */ public GradientStopCollection get_GradientStops() /** @property */ public void set_GradientStops(GradientStopCollection value)
public function get GradientStops () : GradientStopCollection public function set GradientStops (value : GradientStopCollection)
<object> <GradientStopCollection .../> </object>
Valeur de propriété
Type : System.Windows.Media.GradientStopCollectionCollection d'objets GradientStop associés au pinceau, chacun spécifiant une couleur et un décalage le long de l'axe de dégradé du pinceau. La valeur par défaut correspond à un GradientStopCollection vide.
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.
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.
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.
 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.
Davantage de code
| Comment : peindre une zone avec un dégradé radial | Cet exemple indique comment utiliser la classe RadialGradientBrush pour peindre une zone avec un dégradé radial. |
| Comment : animer la position ou la couleur d'un point de dégradé | Cet exemple indique comment animer les Color et Offset d'objets GradientStop. |
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.
