العمل مع الفقرات
الفقرة عبارة عن مجموعة من الأحرف المدمجة في كتلة منطقية وتنتهي بحرف خاص - فاصل الفقرة. في Aspose.Words، يتم تمثيل الفقرة بواسطة فئة Paragraph.
إدراج فقرة
لإدراج فقرة جديدة في المستند، في الواقع، تحتاج إلى إدراج حرف فاصل فقرة فيه. لا يقوم DocumentBuilder.Writeln بإدراج سلسلة نصية في المستند فحسب، بل يضيف أيضًا فاصل فقرات.
يتم تحديد تنسيق الخط الحالي أيضًا بواسطة خاصية Font، ويتم تحديد تنسيق الفقرة الحالي بواسطة خاصية ParagraphFormat. في القسم التالي، سنتناول المزيد من التفاصيل حول تنسيق الفقرة.
يوضح مثال التعليمات البرمجية التالي كيفية إدراج فقرة في مستند:
تنسيق الفقرة
يتم تمثيل تنسيق الفقرة الحالي بواسطة كائن ParagraphFormat الذي يتم إرجاعه بواسطة خاصية ParagraphFormat. يقوم هذا الكائن بتغليف خصائص تنسيق الفقرة المتنوعة المتوفرة في Microsoft Word. يمكنك بسهولة إعادة تعيين تنسيق الفقرة إلى وضعها الافتراضي - نمط عادي، محاذاة إلى اليسار، بدون مسافة بادئة، بدون مسافات، بدون حدود، بدون تظليل - عن طريق استدعاء ClearFormatting.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين تنسيق الفقرة:
تطبيق نمط الفقرة
تدعم بعض كائنات التنسيق، مثل Font أو ParagraphFormat، الأنماط. يتم تمثيل أحد الأنماط المضمنة أو المحددة من قبل المستخدم بواسطة كائن Style، والذي يحتوي على خصائص النمط المناسبة مثل الاسم والنمط الأساسي والخط وتنسيق فقرة النمط وما إلى ذلك.
بالإضافة إلى ذلك، يعرض كائن Style خاصية StyleIdentifier، التي تُرجع معرف النمط المستقل عن اللغة الذي تمثله قيمة تعداد StyleIdentifier. الحقيقة هي أن أسماء الأنماط المضمنة في Microsoft Word مترجمة للغات مختلفة. باستخدام معرف النمط، يمكنك العثور على النمط الصحيح بغض النظر عن لغة المستند. تتوافق قيم التعداد مع أنماط Microsoft Word المضمنة مثل Normal وHeading 1 وHeading 2 وما إلى ذلك. يتم تعيين كافة الأنماط المعرفة من قبل المستخدم على قيمة تعداد StyleIdentifier.User.
يوضح مثال التعليمات البرمجية التالي كيفية تطبيق نمط الفقرة:
قم بإدراج فاصل النمط لوضع أنماط فقرات مختلفة
يمكن إضافة فاصل النمط إلى نهاية الفقرة باستخدام اختصار لوحة المفاتيح Ctrl+Alt+Enter في Microsoft Word. تتيح لك هذه الميزة استخدام نمطين مختلفين للفقرة في نفس الفقرة المطبوعة المنطقية. إذا كنت تريد ظهور بعض النص من بداية عنوان معين في جدول المحتويات، ولكن لا تريد ظهور العنوان بالكامل في جدول المحتويات، فيمكنك استخدام هذه الوظيفة.
يوضح مثال التعليمات البرمجية التالي كيفية إدراج فاصل نمط لاستيعاب أنماط الفقرة المختلفة:
تحديد فاصل نمط الفقرة
يعرض Aspose.Words خاصية BreakIsStyleSeparator العامة في فئة Paragraph لتعريف فقرة بفاصل نمط، كما هو موضح في المثال أدناه:
تطبيق الحدود والتظليل على الفقرة
يتم تمثيل الحدود في Aspose.Words بواسطة فئة BorderCollection - وهي عبارة عن مجموعة من كائنات Border التي يتم الوصول إليها عن طريق الفهرس أو عن طريق نوع الحدود. يتم تمثيل نوع الحد بدوره بواسطة تعداد BorderType. تنطبق بعض قيم التعداد على عناصر وثيقة متعددة أو واحدة فقط. على سبيل المثال، ينطبق BorderType.Bottom على فقرة أو خلية جدول، بينما يحدد BorderType.DiagonalDown حدًا قطريًا في خلية جدول فقط.
تحتوي كل من مجموعة الحدود وكل حد منفصل على سمات متشابهة مثل اللون ونمط الخط وعرض الخط والمسافة من النص والظل الاختياري. يتم تمثيلهم بخصائص تحمل نفس الاسم. يمكنك الحصول على أنواع حدود مختلفة من خلال الجمع بين قيم الخصائص. بالإضافة إلى ذلك، تسمح لك كائنات BorderCollection وBorder بإعادة تعيين هذه القيم إلى قيمها الافتراضية عن طريق استدعاء أسلوب ClearFormatting.
يحتوي Aspose.Words أيضًا على فئة Shading التي تحتوي على سمات التظليل لعناصر المستند. يمكنك تعيين مادة التظليل والألوان المطلوبة التي يتم تطبيقها على الخلفية والمقدمة لعنصر ما باستخدام قيمة تعداد TextureIndex. يتيح لك TextureIndex أيضًا تطبيق أنماط مختلفة على كائن Shading. على سبيل المثال، لتعيين لون الخلفية لعنصر مستند، استخدم قيمة TextureIndex.TextureSolid وقم بتعيين لون تظليل المقدمة بالشكل المناسب.
يوضح مثال التعليمات البرمجية التالي كيفية تطبيق الحدود والتظليل على فقرة:
عد خطوط الفقرة
إذا كنت تريد حساب عدد الأسطر في فقرة لأي مستند Word، فيمكن استخدام نموذج التعليمات البرمجية التالي: