GradientStopCollection

GradientStopCollection class

Contiene una raccolta diGradientStop oggetti.

Per saperne di più, visita ilLavorare con gli elementi grafici articolo di documentazione.

public class GradientStopCollection : IEnumerable<GradientStop>

Proprietà

NomeDescrizione
Count { get; }Ottiene un valore intero che indica il numero di elementi nella raccolta.
Item { get; set; }Ottiene o imposta unGradientStop oggetto nella collezione.

Metodi

NomeDescrizione
Add(GradientStop)Aggiunge uno specificatoGradientStop a un gradiente.
GetEnumerator()Restituisce un enumeratore che scorre la raccolta.
Insert(int, GradientStop)Inserisce unGradientStop alla raccolta a un indice specificato.
Remove(GradientStop)Rimuove uno specificatoGradientStop dalla collezione.
RemoveAt(int)Rimuove unGradientStop dalla raccolta a un indice specificato.

Osservazioni

Non creare istanze di questa classe direttamente. Utilizzare ilGradientStops proprietà per accedere alle interruzioni del gradiente degli oggetti di riempimento.

Esempi

Mostra come aggiungere interruzioni di sfumatura al riempimento sfumato.

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);

// Ottieni la raccolta di interruzioni del gradiente.
GradientStopCollection gradientStops = shape.Fill.GradientStops;

// Modifica la prima interruzione del gradiente.
gradientStops[0].Color = Color.Aqua;
gradientStops[0].Position = 0.1;
gradientStops[0].Transparency = 0.25;

// Aggiunge una nuova interruzione del gradiente alla fine della raccolta.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

// Rimuovi l'interruzione del gradiente all'indice 1.
gradientStops.RemoveAt(1);
// E inserisci un nuovo punto di interruzione del gradiente allo stesso indice 1.
gradientStops.Insert(1, new GradientStop(Color.Chocolate, 0.75, 0.3));

// Rimuove l'ultima interruzione del gradiente nella raccolta.
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);

// Utilizzare l'opzione di conformità per definire la forma utilizzando DML
// se si desidera ottenere la proprietà "GradientStops" dopo il salvataggio del documento.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

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

Guarda anche

GradientStop Class GradientStyle Enum