العمل مع الفقرات
الفقرة عبارة عن مجموعة من الأحرف المدمجة في كتلة منطقية وتنتهي بحرف خاص - فاصل الفقرة. في Aspose.Words، يتم تمثيل الفقرة بواسطة فئة Paragraph.
إدراج فقرة
لإدراج فقرة جديدة في المستند، في الواقع، تحتاج إلى إدراج حرف فاصل فقرة فيه. يقوم DocumentBuilder.writeln بإدراج سلسلة نصية في المستند أيضًا، ولكنه يضيف أيضًا فاصل فقرات.
يتم تحديد تنسيق الخط الحالي أيضًا بواسطة خاصية font ويتم تحديد تنسيق الفقرة الحالي بواسطة خاصية paragraph_format.
يوضح مثال التعليمات البرمجية التالي كيفية إدراج فقرة في مستند:
تنسيق الفقرة
يتم تمثيل تنسيق الفقرة الحالي بواسطة كائن ParagraphFormat الذي يتم إرجاعه بواسطة خاصية paragraph_format. يقوم هذا الكائن بتغليف خصائص تنسيق الفقرة المتنوعة المتوفرة في Microsoft Word. يمكنك بسهولة إعادة تعيين تنسيق الفقرة إلى الوضع الافتراضي إلى النمط العادي، ومحاذاة إلى اليسار، بدون مسافة بادئة، بدون مسافات، بدون حدود، وبدون تظليل عن طريق استدعاء clear_formatting.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين تنسيق الفقرة:
تطبيق نمط الفقرة
تدعم بعض كائنات التنسيق مثل Font أو ParagraphFormat أنماطًا. يتم تمثيل النمط المضمن أو المحدد من قبل المستخدم بواسطة كائن Style الذي يحتوي على خصائص النمط المقابلة مثل الاسم والنمط الأساسي وتنسيق الخط والفقرة للنمط، وما إلى ذلك.
علاوة على ذلك، يوفر كائن Style خاصية Style.style_identifier التي تُرجع معرف نمط مستقل عن اللغة يمثله قيمة تعداد StyleIdentifier. النقطة المهمة هي أن أسماء الأنماط المضمنة في Microsoft Word مترجمة للغات مختلفة. باستخدام معرف النمط، يمكنك العثور على النمط الصحيح بغض النظر عن لغة المستند. تتوافق قيم التعداد مع أنماط Microsoft Word المضمنة مثل Normal وHeading 1 وHeading 2 وما إلى ذلك. ويتم تعيين قيمة StyleIdentifier.USER لجميع الأنماط المعرفة من قبل المستخدم
يوضح مثال التعليمات البرمجية التالي كيفية تطبيق نمط الفقرة:
قم بإدراج فاصل النمط لوضع أنماط فقرات مختلفة
يمكن إضافة فاصل النمط إلى نهاية الفقرة باستخدام Ctrl + Alt + Enter Keyboard Shortcut في MS Word. تتيح هذه الميزة استخدام نمطين مختلفين للفقرة في فقرة مطبوعة منطقية واحدة. إذا كنت تريد ظهور بعض النص من بداية عنوان معين في جدول المحتويات ولكنك لا تريد العنوان بأكمله في جدول المحتويات، فيمكنك استخدام هذه الميزة
يوضح مثال التعليمات البرمجية التالي كيفية إدراج فاصل نمط لاستيعاب أنماط الفقرة المختلفة:
تحديد فاصل نمط الفقرة
يوفر Aspose.Words خاصية عامة break_is_style_separator في فئة Paragraph تسمح بتحديد فقرة فاصل النمط كما هو موضح في المثال الموضح أدناه:
تطبيق الحدود والتظليل على الفقرة
يتم تمثيل الحدود بواسطة BorderCollection. هذه مجموعة من كائنات Border التي يتم الوصول إليها عن طريق الفهرس أو عن طريق نوع الحدود. يتم تمثيل نوع الحدود بواسطة تعداد BorderType. تنطبق بعض قيم التعداد على عدة عناصر مستند أو عنصر واحد فقط. على سبيل المثال، ينطبق BorderType.BOTTOM على فقرة أو خلية جدول بينما يحدد BorderType.DIAGONALDOWN الحد القطري في خلية الجدول فقط.
تحتوي كل من مجموعة الحدود وكل حد منفصل على سمات متشابهة مثل اللون ونمط الخط وعرض الخط والمسافة من النص والظل الاختياري. يتم تمثيلهم بخصائص تحمل نفس الاسم. يمكنك تحقيق أنواع مختلفة من الحدود من خلال دمج قيم الخاصية. بالإضافة إلى ذلك، يسمح لك كل من كائنات BorderCollection وBorder بإعادة تعيين هذه القيم إلى الوضع الافتراضي عن طريق استدعاء أسلوب Border.clear_formatting.
يحتوي Aspose.Words أيضًا على فئة Shading التي تحتوي على سمات تظليل لعناصر المستند. يمكنك ضبط نسيج التظليل المطلوب والألوان التي يتم تطبيقها على خلفية ومقدمة العنصر.
يتم تعيين نسيج التظليل بقيمة تعداد TextureIndex التي تسمح بتطبيق أنماط مختلفة على كائن Shading. على سبيل المثال، لتعيين لون خلفية لعنصر مستند، استخدم قيمة TextureIndex.TEXTURE_SOLID وقم بتعيين لون تظليل المقدمة بالشكل المناسب. يوضح المثال أدناه كيفية تطبيق الحدود والتظليل على الفقرة.
يوضح مثال التعليمات البرمجية التالي كيفية تطبيق الحدود والتظليل على فقرة: