ListFormat

ListFormat class

يسمح بالتحكم في تنسيق القائمة المطبق على فقرة.

public class ListFormat

الخصائص

اسم وصف
IsListItem { get; } صحيح عندما يتم تطبيق تنسيق تعداد نقطي أو رقمي على الفقرة.
List { get; set; } الحصول على أو تعيين القائمة التي تكون هذه الفقرة عضوًا فيها.
ListLevel { get; } إرجاع تنسيق مستوى القائمة بالإضافة إلى أي تجاوزات تنسيق مطبقة على الفقرة الحالية.
ListLevelNumber { get; set; } الحصول على أو تحديد رقم مستوى القائمة (من 0 إلى 8) للفقرة.

طُرق

اسم وصف
ApplyBulletDefault() يبدأ قائمة افتراضية جديدة ذات تعداد نقطي ويطبقها على الفقرة.
ApplyNumberDefault() يبدأ قائمة مرقمة افتراضية جديدة ويطبقها على الفقرة.
ListIndent() زيادة مستوى قائمة الفقرة الحالية بمقدار مستوى واحد.
ListOutdent() تقليل مستوى قائمة الفقرة الحالية بمستوى واحد.
RemoveNumbers() يزيل الأرقام أو الرموز النقطية من الفقرة الحالية ويضبط مستوى القائمة على صفر.

ملاحظات

يمكن أن تكون الفقرة في مستند Microsoft Word ذات تعداد نقطي أو رقمي.

لا تقوم بإنشاء كائنات منListFormat فئة مباشرة. يمكنك الوصول إليهاListFormat كخاصية لكائن آخر يمكن أن يكون لها تنسيق قائمة مرتبط بها. في الوقت الحالي ، الكائنات التي يمكن أن يكون لها تنسيق قائمة هي:Paragraph ، Style وDocumentBuilder.

ListFormat من أParagraph specified ما هو تنسيق القائمة ومستوى القائمة المطبقين على تلك الفقرة المعينة.

ListFormat من أStyle(ينطبق على أنماط الفقرة فقط) يسمح بتحديد تنسيق القائمة وقائمة المستوى المطبقة على جميع فقرات هذا النمط المعين.

ListFormat من أDocumentBuilder يوفر الوصول إلى تنسيق القائمة في موضع المؤشر الحالي داخل ملفDocumentBuilder.

يتم تخزين قائمة التنسيق نفسها داخل ملفList كائن مخزّن بشكل منفصل عن الفقرات. يتم تخزين كائنات القائمة داخل ملفListCollection مجموعة. هناك واحد ListCollection جمع لكلDocument.

لا تنتمي الفقرات فعليًا إلى قائمة. تشير الفقرات just إلى كائن قائمة معين عبر ملفList property ومستوى معين في القائمة عبر ملفListLevelNumber property. من خلال تعيين هاتين الخاصيتين ، يمكنك التحكم في التعداد والترقيم الذي يتم تطبيقه على فقرة.

أمثلة

يوضح كيفية العمل مع مستويات القائمة.

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

Assert.False(builder.ListFormat.IsListItem);

// تسمح لنا القائمة بتنظيم وتزيين مجموعات من الفقرات برموز بادئة ومسافات بادئة.
// يمكننا إنشاء قوائم متداخلة عن طريق زيادة مستوى المسافة البادئة. 
// يمكننا بدء قائمة وإنهائها باستخدام خاصية "تنسيق القائمة" الخاصة بمنشئ المستندات. 
// كل فقرة نضيفها بين بداية القائمة ونهايتها ستصبح عنصرًا في القائمة.
// يوجد أدناه نوعان من القوائم التي يمكننا إنشاؤها باستخدام أداة إنشاء المستندات.
// 1 - قائمة ذات تعداد رقمي:
// تقوم القوائم المرقمة بإنشاء ترتيب منطقي لفقراتها عن طريق ترقيم كل عنصر.
builder.ListFormat.List = doc.Lists.Add(ListTemplate.NumberDefault);

Assert.True(builder.ListFormat.IsListItem);

// من خلال تعيين خاصية "ListLevelNumber" ، يمكننا زيادة مستوى القائمة
// لبدء قائمة فرعية قائمة بذاتها في عنصر القائمة الحالي.
// يستخدم قالب قائمة Microsoft Word المسمى "NumberDefault" الأرقام لإنشاء مستويات القائمة لمستوى القائمة الأول.
// تستخدم مستويات القائمة الأعمق أحرفًا وأرقامًا رومانية صغيرة. 
for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// 2 - قائمة نقطية:
// ستطبق هذه القائمة مسافة بادئة ورمز نقطي ("•") قبل كل فقرة.
// ستستخدم المستويات الأعمق من هذه القائمة رموزًا مختلفة ، مثل "■" و "".
builder.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);

for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// يمكننا تعطيل تنسيق القائمة لعدم تنسيق أي فقرات لاحقة كقوائم عن طريق إلغاء تعيين علامة "القائمة".
builder.ListFormat.List = null;

Assert.False(builder.ListFormat.IsListItem);

doc.Save(ArtifactsDir + "Lists.SpecifyListLevel.docx");

أنظر أيضا