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

أنظر أيضا

GradientStop Class GradientStyle Enum