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; }Hämtar ett heltal som anger antalet objekt i samlingen.
Item { get; set; }Hämtar eller ställer in enGradientStop objekt i samlingen.

Metoder

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

Anmärkningar

Du skapar inte instanser av den här klassen direkt. AnvändGradientStops egenskap för att komma åt gradientstopp 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);

// Hämta samling av gradientstopp.
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 gradientstopp i slutet av samlingen.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

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

// Ta bort sista gradientstoppet 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 alternativet compliance för att definiera formen med DML
// om du vill få egenskapen "GradientStops" efter att dokumentet sparats.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

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

Se även

GradientStop Class GradientStyle Enum