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