GradientStopCollection

GradientStopCollection class

Innehåller en samling avGradientStop objekt.

För att lära dig mer, besökArbeta med grafiska element dokumentationsartikel.

public class GradientStopCollection : IEnumerable<GradientStop>

Egenskaper

namnBeskrivning
Count { get; }Får ett heltalsvärde som anger antalet föremål i samlingen.
Item { get; set; }Hämtar eller sätter enGradientStop objekt i samlingen.

Metoder

namnBeskrivning
Add(GradientStop)Lägger till en specificeradGradientStop till en gradient.
GetEnumerator()Returnerar en uppräkning som itererar genom samlingen.
Insert(int, GradientStop)Infogar enGradientStop till samlingen vid ett specificerat index.
Remove(GradientStop)Tar bort en angivenGradientStop från samlingen.
RemoveAt(int)Tar bort enGradientStop från samlingen vid ett specificerat index.

Anmärkningar

Du skapar inte instanser av den här klassen direkt. AnvändGradientStopsegenskap för att komma åt övertoningsstopp för fyllningsobjekt.

Exempel

Visar hur man lägger till övertoningsstopp i övertoningsfyllningen.

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

// Få gradient stoppar samling.
GradientStopCollection gradientStops = shape.Fill.GradientStops;

// Ändra första gradientstopp.            
gradientStops[0].Color = Color.Aqua;            
gradientStops[0].Position = 0.1;
gradientStops[0].Transparency = 0.25;

// Lägg till nytt övertoningsstopp i slutet av samlingen.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

// Ta bort gradientstopp vid index 1.
gradientStops.RemoveAt(1);
// Och infoga nytt gradientstopp vid samma index 1.
gradientStops.Insert(1, new GradientStop(Color.Chocolate, 0.75, 0.3));

// Ta bort sista gradientstopp i samlingen.
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);

// Använd efterlevnadsalternativet för att definiera formen med DML
// om du vill få egenskapen "GradientStops" efter att dokumentet har sparats.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

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

Se även