TabStopCollection

TabStopCollection class

مجموعة منTabStop الكائنات التي تمثل علامات تبويب مخصصة لفقرة أو نمط.

لمعرفة المزيد، قم بزيارةنموذج كائن مستند Aspose.Words (DOM) مقالة توثيقية.

public class TabStopCollection : InternableComplexAttr

الخصائص

اسموصف
Count { get; }الحصول على عدد علامات الجدولة في المجموعة.
Item { get; }الحصول على علامة جدولة عند الفهرس المحدد. (2 indexers)

طُرق

اسموصف
Add(TabStop)إضافة علامة جدولة أو استبدالها في المجموعة.
Add(double, TabAlignment, TabLeader)إضافة علامة جدولة أو استبدالها في المجموعة.
After(double)الحصول على علامة الجدولة الأولى على يمين الموضع المحدد.
Before(double)الحصول على علامة الجدولة الأولى على يسار الموضع المحدد.
Clear()حذف كافة مواضع علامات الجدولة.
override Equals(object)تحديد ما إذا كان الكائن المحدد يساوي قيمة الكائن الحالي.
Equals(TabStopCollection)تحديد ما إذا كان المحددTabStopCollection يساوي القيمة الحاليةTabStopCollection .
override GetHashCode()بمثابة دالة تجزئة لهذا النوع.
GetIndexByPosition(double)الحصول على فهرس علامة الجدولة بالموضع المحدد بالنقاط.
GetPositionByIndex(int)الحصول على موضع علامة التبويب (بالنقاط) عند الفهرس المحدد.
RemoveByIndex(int)إزالة علامة الجدولة عند الفهرس المحدد من المجموعة.
RemoveByPosition(double)إزالة علامة الجدولة عند الموضع المحدد من المجموعة.

ملاحظات

في مستندات Microsoft Word، يمكن تعريف علامة الجدولة في خصائص نمط الفقرة أو مباشرة في خصائص الفقرة. يمكن أن يعتمد النمط على نمط آخر. وبالتالي، فإن المجموعة الكاملة من علامات الجدولة لكائن معين هي عبارة عن مجموعة من علامات الجدولة المحددة مباشرة على هذا الكائن وعلامات الجدولة الموروثة من الأنماط الأصلية.

في Aspose.Words، عندما تحصل على ملفTabStopCollectionبالنسبة لفقرة أو نمط، فهو يحتوي فقط على علامات الجدولة المخصصة المحددة مباشرة لهذه الفقرة أو النمط. لا تتضمن المجموعة علامات الجدولة المحددة في الأنماط الأصلية أو علامات الجدولة الافتراضية.

أمثلة

يوضح كيفية التعامل مع مجموعة علامات الجدولة الخاصة بالمستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 نقطة هي "بوصة" واحدة في مسطرة إيقاف علامة التبويب في Microsoft Word.
tabStops.Add(new TabStop(72.0));
tabStops.Add(new TabStop(432.0, TabAlignment.Right, TabLeader.Dashes));

Assert.AreEqual(2, tabStops.Count);
Assert.IsFalse(tabStops[0].IsClear);
Assert.IsFalse(tabStops[0].Equals(tabStops[1]));

// يأخذ كل حرف "علامة تبويب" مؤشر المنشئ إلى موقع علامة التبويب التالية.
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// تحصل كل فقرة على مجموعة علامات الجدولة الخاصة بها، والتي تستنسخ قيمها من مجموعة علامات الجدولة الخاصة بمنشئ المستندات.
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// يمكن أن توجهنا مجموعة علامات التبويب إلى TabStops قبل وبعد مواضع معينة.
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// يمكننا مسح مجموعة علامات الجدولة الخاصة بالفقرة للعودة إلى سلوك الجدولة الافتراضي.
paragraphs[1].ParagraphFormat.TabStops.Clear();

Assert.AreEqual(0, paragraphs[1].ParagraphFormat.TabStops.Count);

doc.Save(ArtifactsDir + "TabStopCollection.TabStopCollection.docx");

أنظر أيضا

TabStop Class TableStyle Class