الحواشي السفلية والحواشي الختامية

الحواشي السفلية والحواشي الختامية

Aspose.Words FOSS لـ .NET يمثل الحواشي السفلية والحواشي الختامية باستخدام فئة عقدة واحدة Footnote مميزة بخاصية FootnoteType، إلى جانب فئات خيارات الترقيم والفواصل المنفصلة في مساحة الاسم Aspose.Words.Notes.

قراءة محتوى الحواشي السفلية والحواشي الختامية

Footnote هو عقدة قصة مركبة — مثل Body أو خلية جدول، يحتوي على Paragraphs و Tables — التي تحتفظ بنص حاشية سفلية أو حاشية ختامية واحدة. خاصية FootnoteType الخاصة به (قيمة تعداد FootnoteType، إما Footnote أو Endnote) تميز النوع. ReferenceMark تُرجِع حرف علامة الإشارة المُكوَّن، ActualReferenceMark تُرجِع العلامة التي تم عرضها فعليًا (مع مراعاة الترقيم التلقائي)، وIsAuto تُبلغ عما إذا كانت العلامة مُرقَّمة تلقائيًا. ParentParagraph تحدد الفقرة في جسم المستند الرئيسي حيث تظهر إشارة الحاشية السفلية أو الختامية. GetText() تستخرج محتوى النص العادي للحاشية، مقلدةً الطريقة المتوفرة على العقد الأخرى على مستوى القصة.

تهيئة الترقيم والموضع

يتم التحكم في سلوك الترقيم والموضع بشكل منفصل للحواشي السفلية والحواشي الختامية عبر FootnoteOptions و EndnoteOptions، كلاهما يطبق واجهة IFootnoteOptions المشتركة. FootnoteOptions.Position (قيمة FootnotePosition — BottomOfPage أو BeneathText) و EndnoteOptions.Position (قيمة EndnotePosition — EndOfSection أو EndOfDocument) تتحكم في مكان وضع كل نوع. كلاهما يعرض NumberStyle، StartNumber، وRestartRule (قيمة FootnoteNumberingRule — Continuous، RestartSection، RestartPage أو Default) للتحكم في تسلسل الترقيم. بالإضافة إلى ذلك، يكشف FootnoteOptions عن Columns، لتنسيق الحواشي السفلية في أسفل الصفحة عبر أعمدة متعددة.

فواصل الحواشي السفلية والحواشي الختامية

FootnoteSeparator هو عقدة قصة تحتفظ بالمحتوى الذي يضيفه Word بين جسم المستند الرئيسي وهوامشه/هوامش النهاية — الخط الأفقي القصير افتراضيًا، لكنه يمكن أن يحتوي على أي محتوى فقرة. خاصية SeparatorType الخاصة به (قيمة FootnoteSeparatorType) تميز الأدوار الستة للفواصل التي يعرفها Word: FootnoteSeparator، FootnoteContinuationSeparator، FootnoteContinuationNotice، وما يعادلها في هوامش النهاية. FootnoteSeparatorCollection يوفر وصولًا مكتوبًا إلى جميع عقد الفواصل في المستند عبر GetByFootnoteSeparatorType(FootnoteSeparatorType).

نصائح وأفضل الممارسات

• تحقق من Footnote.FootnoteType قبل افتراض أن عقدة Footnote هي حاشية سفلية — نفس الفئة تمثل كلًا من الحواشي السفلية وحواشي النهاية.
• استخدم ActualReferenceMark بدلاً من ReferenceMark عندما تحتاج إلى العلامة كما ستُظهر فعليًا، لأن العلامات المرقمة تلقائيًا تختلف عن حرف العلامة المُكوَّن.
• قم بتهيئة FootnoteOptions وEndnoteOptions قبل إضافة محتوى الحاشية السفلية/حاشية النهاية بحيث تُطبق قواعد الترقيم بشكل متسق من أول ملاحظة.
• نادرًا ما يتم تخصيص محتوى FootnoteSeparator — معظم المستندات تعتمد على الفاصل الافتراضي في Word — لكنه متاح بالكامل إذا كان المستند يحتاج إلى إشعار استمرارية مخصص.

مشكلات شائعة

FAQ

كيف أميز الحاشية السفلية عن الحاشية الختامية في الشيفرة؟

تحقق من الخاصية FootnoteType في كائن Footnote — تُعيد FootnoteType.Footnote أو FootnoteType.Endnote.

هل يمكن أن تكون للحواشي السفلية والحواشي الختامية قواعد ترقيم مختلفة؟

نعم — يتم تكوين FootnoteOptions وEndnoteOptions بشكل مستقل، كل منهما له Position، NumberStyle، StartNumber، وRestartRule الخاص به.

ما هو الغرض من FootnoteSeparator؟

إنه يمثل المحتوى الذي تُدخله Word لفصل جسم المستند الرئيسي بصريًا عن حواشيه السفلية أو الختامية، والإشعار المعروض عندما تستمر الحاشية السفلية إلى الصفحة التالية.

هل يدعم Footnote الجداول داخل الملاحظة؟

نعم — يتيح Footnote خاصية Tables إلى جانب Paragraphs، لأنه عقدة قصة مركبة مثل جسم المستند الرئيسي.

API Reference ملخص

انظر أيضاً

• Aspose.Words for .NET — Enterprise Documentation