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كخاصية لكائن آخر يُمكنه استخدام تنسيق قائمة مع x000d_. حاليًا، الكائنات التي يُمكنه استخدام تنسيق قائمة مع x000d_ هي:Paragraph ، Style وDocumentBuilder.

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

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

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

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

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

أمثلة

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

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

Assert.False(builder.ListFormat.IsListItem);

// تسمح لنا القائمة بتنظيم وتزيين مجموعات من الفقرات باستخدام رموز البادئة والمسافات البادئة.
 //يمكننا إنشاء قوائم متداخلة عن طريق زيادة مستوى المسافة البادئة.
 // يمكننا أن نبدأ وننهي القائمة باستخدام خاصية "ListFormat" الموجودة في منشئ المستندات.
// كل فقرة نضيفها بين بداية القائمة ونهايتها ستصبح عنصرًا في القائمة.
// فيما يلي نوعان من القوائم التي يمكننا إنشاؤها باستخدام منشئ المستندات.
// 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");

أنظر أيضا

ListCollection Class ListLabel Class