GradientStopCollection

GradientStopCollection class

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

لمعرفة المزيد، قم بزيارةالعمل مع العناصر الرسومية مقالة توثيقية.

public class GradientStopCollection : IEnumerable<GradientStop>

الخصائص

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

طُرق

اسموصف
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.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);

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

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

أنظر أيضا