العمل مع القوائم
القائمة في مستند Microsoft Word هي مجموعة من خصائص تنسيق الفقرة. يمكن استخدام القوائم في المستندات لتنظيم النص وترتيبه وتمييزه. تعد القوائم طريقة رائعة لتنظيم البيانات في المستندات بطريقة تسهل على القراء استيعاب النقاط الرئيسية وفهمها.
يمكن أن تحتوي كل قائمة على ما يصل إلى 9 مستويات، ويتم تحديد خصائص التنسيق مثل نمط الأرقام وقيمة البداية والمسافة البادئة وموضع علامة التبويب وغيرها بشكل منفصل لكل مستوى.
في Aspose.Words، يتم تمثيل العمل مع القوائم بمساحة الاسم Lists. ومع ذلك، ينتمي كائن List دائمًا إلى ListCollection.
توضح هذه المقالة العمل برمجيًا مع القوائم باستخدام Aspose.Words.
إنشاء قوائم عن طريق تطبيق تنسيق القائمة
يتيح Aspose.Words إنشاء القوائم بسهولة من خلال تطبيق تنسيق القائمة. يوفر DocumentBuilder خاصية ListFormat التي تقوم بإرجاع كائن ListFormat. يحتوي هذا الكائن على عدة طرق لبدء القائمة وإنهائها ولزيادة/تقليل المسافة البادئة. هناك نوعان عامان من القوائم في Microsoft Word: نقطية ومرقمة:
- لبدء قائمة ذات تعداد نقطي، اتصل بـ ApplyBulletDefault
- لبدء قائمة مرقمة، اتصل بـ ApplyNumberDefault
تتم إضافة الرمز النقطي أو الرقم والتنسيق إلى الفقرة الحالية وجميع الفقرات الأخرى التي تم إنشاؤها باستخدام DocumentBuilder حتى يتم استدعاء RemoveNumbers لإيقاف تنسيق القائمة ذات التعداد النقطي.
في مستندات Word، قد تتكون القوائم من تسعة مستويات كحد أقصى. يحدد تنسيق القائمة لكل مستوى التعداد النقطي أو الرقم المستخدم، والمسافة البادئة اليسرى، والمسافة بين التعداد النقطي والنص وما إلى ذلك. تعمل الطرق التالية على تغيير مستوى القائمة وتطبيق خصائص تنسيق المستوى الجديد:
- لزيادة مستوى القائمة للفقرة الحالية بمستوى واحد، اتصل بـ ListIndent
- لتقليل مستوى القائمة للفقرة الحالية بمقدار مستوى واحد، اتصل بـ ListOutdent
يمكنك أيضًا استخدام خاصية ListLevelNumber للحصول على مستوى القائمة للفقرة أو تعيينه.
يوضح مثال التعليمات البرمجية التالي كيفية إنشاء قائمة متعددة المستويات:
تحديد التنسيق لمستوى القائمة
يتم إنشاء الكائنات على مستوى القائمة تلقائيًا عند إنشاء القائمة. استخدم خصائص وأساليب فئة ListLevel للتحكم في تنسيق المستويات الفردية للقائمة.
إعادة تشغيل القائمة لكل قسم
يمكنك إعادة تشغيل قائمة لكل قسم باستخدام خاصية IsRestartAtEachSection. لاحظ أن هذا الخيار مدعوم فقط بتنسيقات المستندات RTF وDOC وDOCX. ستتم كتابة هذا الخيار في DOCX فقط إذا كان OoxmlCompliance أعلى من Ecma376.
يوضح مثال التعليمات البرمجية التالي كيفية إنشاء قائمة وإعادة تشغيلها لكل قسم: