GradientStop

GradientStop class

Représente un arrêt de dégradé.

Pour en savoir plus, visitez leTravailler avec des éléments graphiques article de documentation.

public class GradientStop

Constructeurs

NomLa description
GradientStop(Color, double)Initialise une nouvelle instance duGradientStop classe.
GradientStop(Color, double, double)Initialise une nouvelle instance duGradientStop classe.

Propriétés

NomLa description
BaseColor { get; }Obtient une valeur représentant la couleur de l’arrêt du dégradé sans aucun modificateur.
Color { get; set; }Obtient ou définit une valeur représentant la couleur de l’arrêt du dégradé.
Position { get; set; }Obtient ou définit une valeur représentant la position d’un arrêt dans le gradient exprimée en pourcentage dans la plage de 0,0 à 1,0.
Transparency { get; set; }Obtient ou définit une valeur représentant la transparence du remplissage dégradé exprimée en pourcentage dans la plage de 0,0 à 1,0.

Méthodes

NomLa description
Remove()Supprime l’arrêt du dégradé du parentGradientStopCollection .

Exemples

Montre comment ajouter des arrêts de dégradé au remplissage dégradé.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertShape(ShapeType.Rectangle, 80, 80);
shape.Fill.TwoColorGradient(Color.Green, Color.Red, GradientStyle.Horizontal, GradientVariant.Variant2);

// Obtenir la collection d'arrêts de dégradé.
GradientStopCollection gradientStops = shape.Fill.GradientStops;

// Changer le premier arrêt du dégradé.
gradientStops[0].Color = Color.Aqua;
gradientStops[0].Position = 0.1;
gradientStops[0].Transparency = 0.25;

// Ajouter un nouvel arrêt de dégradé à la fin de la collection.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

// Supprimer l'arrêt du dégradé à l'index 1.
gradientStops.RemoveAt(1);
// Et insérez un nouvel arrêt de dégradé au même index 1.
gradientStops.Insert(1, new GradientStop(Color.Chocolate, 0.75, 0.3));

// Supprime le dernier arrêt de dégradé de la collection.
gradientStop = gradientStops[2];
gradientStops.Remove(gradientStop);

Assert.AreEqual(2, gradientStops.Count);

Assert.AreEqual(Color.FromArgb(255, 0, 255, 255), gradientStops[0].BaseColor);
Assert.AreEqual(Color.Aqua.ToArgb(), gradientStops[0].Color.ToArgb());
Assert.AreEqual(0.1d, gradientStops[0].Position, 0.01d);
Assert.AreEqual(0.25d, gradientStops[0].Transparency, 0.01d);

Assert.AreEqual(Color.Chocolate.ToArgb(), gradientStops[1].Color.ToArgb());
Assert.AreEqual(0.75d, gradientStops[1].Position, 0.01d);
Assert.AreEqual(0.3d, gradientStops[1].Transparency, 0.01d);

// Utilisez l'option de conformité pour définir la forme à l'aide de DML
// si vous souhaitez obtenir la propriété « GradientStops » après l'enregistrement du document.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

doc.Save(ArtifactsDir + "Shape.GradientStops.docx", saveOptions);

Voir également

GlowFormat Class GradientStopCollection Class