GradientStopCollection

GradientStopCollection class

Contient une collection deGradientStop objets.

public class GradientStopCollection : IEnumerable<GradientStop>

Propriétés

Nom La description
Count { get; } Obtient une valeur entière indiquant le nombre d’éléments dans la collection.
Item { get; set; } Obtient ou définit unGradientStop objet dans la collection.

Méthodes

Nom La description
Add(GradientStop) Ajoute un spécifiéGradientStop à un dégradé.
GetEnumerator() Renvoie un énumérateur qui parcourt la collection.
Insert(int, GradientStop) Insère unGradientStop à la collection à un index spécifié.
Remove(GradientStop) Supprime un spécifiéGradientStop de la collection.
RemoveAt(int) Supprime unGradientStopde la collection à un index spécifié.

Remarques

Vous ne créez pas d’instances de cette classe directement. Utilisez leGradientStops propriété pour accéder aux arrêts de dégradé des objets de remplissage.

Exemples

Montre comment ajouter des points 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);

// Récupère 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;

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

// Supprime l'arrêt du dégradé à l'index 1.
gradientStops.RemoveAt(1);
// Et insère 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.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