GradientStopCollection

GradientStopCollection class

Contiene una raccolta diGradientStop oggetti.

Per saperne di più, visita ilLavorare con 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 aGradientStop oggetto nella raccolta.

Metodi

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

Osservazioni

Non crei direttamente istanze di questa classe. Utilizza il fileGradientStopsproprietà per accedere alle interruzioni del gradiente degli oggetti di riempimento.

Esempi

Mostra come aggiungere interruzioni sfumatura al riempimento sfumatura.

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

// Rimuove l'interruzione del gradiente all'indice 1.
gradientStops.RemoveAt(1);
// E inserisce una nuova 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);

// Utilizza l'opzione di conformità per definire la forma utilizzando DML
// se vuoi 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