GradientStopCollection

GradientStopCollection class

يحتوي على مجموعة منGradientStop الكائنات .

public class GradientStopCollection : IEnumerable<GradientStop>

الخصائص

اسم وصف
Count { get; } الحصول على قيمة عددية تشير إلى عدد العناصر في المجموعة.
Item { get; set; } يحصل أو يحدد أGradientStop كائن في المجموعة .

طُرق

اسم وصف
Add(GradientStop) يضيف محددًاGradientStop إلى التدرج اللوني .
GetEnumerator() إرجاع عداد يتكرر خلال المجموعة.
Insert(int, GradientStop) إدراج أGradientStop إلى المجموعة في فهرس محدد.
Remove(GradientStop) يزيل ملفGradientStop من المجموعة.
RemoveAt(int) يزيل أGradientStopمن المجموعة في فهرس محدد.

ملاحظات

لا يمكنك إنشاء مثيلات من هذه الفئة مباشرةً. استخدم ملفGradientStops خاصية للوصول إلى التوقفات المتدرجة لكائنات التعبئة.

أمثلة

يوضح كيفية إضافة نقاط توقف متدرجة لتعبئة التدرج.

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

// احصل على مجموعة نقاط التدرج.
GradientStopCollection gradientStops = shape.Fill.GradientStops;

// تغيير أول توقف متدرج.
gradientStops[0].Color = Color.Aqua;
gradientStops[0].Position = 0.1;
gradientStops[0].Transparency = 0.25;

// أضف نقطة توقف متدرجة جديدة إلى نهاية المجموعة.
GradientStop gradientStop = new GradientStop(Color.Brown, 0.5);
gradientStops.Add(gradientStop);

// إزالة توقف التدرج عند الفهرس 1.
gradientStops.RemoveAt(1);
// وأدخل نقطة توقف متدرجة جديدة في نفس الفهرس 1.
gradientStops.Insert(1, new GradientStop(Color.Chocolate, 0.75, 0.3));

// إزالة آخر توقف متدرج في المجموعة.
gradientStop = gradientStops[2];
gradientStops.Remove(gradientStop);

Assert.AreEqual(2, gradientStops.Count);

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

// استخدم خيار التوافق لتحديد الشكل باستخدام DML
// إذا كنت تريد الحصول على خاصية "GradientStops" بعد حفظ المستند.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions { Compliance = OoxmlCompliance.Iso29500_2008_Strict };

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

أنظر أيضا