GradientStopCollection

GradientStopCollection class

Contient une collection deGradientStop objets.

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

public class GradientStopCollection : IEnumerable<GradientStop>

Propriétés

NomLa 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

NomLa 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 unGradientStop de la collection à un index spécifié.

Remarques

Vous ne créez pas directement d’instances de cette classe. Utilisez leGradientStopsproprié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;

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

// Ajoute un nouveau point 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érez un nouveau point 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

GradientStop Class GradientStyle Enum