GradientStopCollection

GradientStopCollection class

Contiene una colección deGradientStop objetos.

Para obtener más información, visite elTrabajar con elementos gráficos Artículo de documentación.

public class GradientStopCollection : IEnumerable<GradientStop>

Propiedades

NombreDescripción
Count { get; }Obtiene un valor entero que indica la cantidad de elementos en la colección.
Item { get; set; }Obtiene o establece unGradientStop objeto en la colección.

Métodos

NombreDescripción
Add(GradientStop)Agrega un valor especificadoGradientStop a un gradiente.
GetEnumerator()Devuelve un enumerador que itera a través de la colección.
Insert(int, GradientStop)Inserta unGradientStop a la colección en un índice especificado.
Remove(GradientStop)Elimina un valor especificadoGradientStop de la colección.
RemoveAt(int)Elimina unGradientStop de la colección en un índice especificado.

Observaciones

No se crean instancias de esta clase directamente. Utilice elGradientStops propiedad para acceder a las paradas de degradado de los objetos de relleno.

Ejemplos

Muestra cómo agregar paradas de degradado al relleno de degradado.

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

// Obtener la colección de paradas de degradado.
GradientStopCollection gradientStops = shape.Fill.GradientStops;

// Cambiar la primera parada del gradiente.
gradientStops[0].Color = Color.Aqua;
gradientStops[0].Position = 0.1;
gradientStops[0].Transparency = 0.25;

//Agrega un nuevo punto de degradado al final de la colección.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

// Eliminar la parada de degradado en el índice 1.
gradientStops.RemoveAt(1);
// E inserte un nuevo punto de degradado en el mismo índice 1.
gradientStops.Insert(1, new GradientStop(Color.Chocolate, 0.75, 0.3));

//Eliminar la última parada de degradado en la colección.
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);

// Utilice la opción de cumplimiento para definir la forma usando DML
// si desea obtener la propiedad "GradientStops" después de guardar el documento.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

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

Ver también

GradientStop Class GradientStyle Enum