TabStopCollection
محتويات
[
يخفي
]TabStopCollection class
مجموعة منTabStop الكائنات التي تمثل علامات تبويب مخصصة لفقرة أو نمط.
لمعرفة المزيد، قم بزيارةنموذج كائن المستند (DOM) في Aspose.Words مقالة توثيقية.
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) | يزيل علامة التبويب في الموضع المحدد من المجموعة. |
ملاحظات
في مستندات مايكروسوفت وورد، يمكن تعريف علامة الجدولة ضمن خصائص نمط paragraph أو مباشرةً ضمن خصائص الفقرة. يمكن أن يستند النمط إلى نمط آخر. . لذلك، فإن المجموعة الكاملة لعلامات الجدولة لكائن معين هي مزيج من علامات الجدولة المُعرّفة مباشرةً في هذا الكائن وعلامات الجدولة الموروثة من الأنماط الأصلية.
في 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);
// يمكن لمجموعة علامات التبويب أن تشير إلينا إلى علامات التبويب قبل وبعد مواضع معينة.
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");
أنظر أيضا
- class InternableComplexAttr
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words
