GradientStop

GradientStop class

Rappresenta un’interruzione del gradiente.

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

public class GradientStop

Costruttori

NomeDescrizione
GradientStop(Color, double)Inizializza una nuova istanza diGradientStop classe.
GradientStop(Color, double, double)Inizializza una nuova istanza diGradientStop classe.

Proprietà

NomeDescrizione
BaseColor { get; }Ottiene un valore che rappresenta il colore del gradiente senza modificatori.
Color { get; set; }Ottiene o imposta un valore che rappresenta il colore del punto di interruzione del gradiente.
Position { get; set; }Ottiene o imposta un valore che rappresenta la posizione di una fermata all’interno del gradiente espresso come percentuale nell’intervallo da 0,0 a 1,0.
Transparency { get; set; }Ottiene o imposta un valore che rappresenta la trasparenza del riempimento sfumato espresso come percentuale nell’intervallo da 0,0 a 1,0.

Metodi

NomeDescrizione
Remove()Rimuove l’interruzione del gradiente dal genitoreGradientStopCollection .

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