FootnoteType

FootnoteType enumeration

تحديد ما إذا كانت هذه حاشية سفلية أو تعليق ختامي.

public enum FootnoteType

قيم

اسم قيمة وصف
Footnote 0 الكائن عبارة عن حاشية سفلية .
Endnote 1 الكائن عبارة عن تعليق ختامي .

ملاحظات

يتم تمثيل كل من الحواشي السفلية والتعليقات الختامية بواسطة الكائنات بواسطةFootnote فئة . يستخدمFootnoteType للتمييز بين الحواشي والتعليقات الختامية.

أمثلة

يوضح كيفية الإشارة إلى نص مع حاشية سفلية وتعليق ختامي.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل بعض النص وقم بتمييزه بحاشية سفلية مع تعيين خاصية IsAuto على "true" افتراضيًا ،
// لذلك سيتم ترقيم العلامة الظاهرة في النص الأساسي تلقائيًا عند "1" ،
// وستظهر الحاشية السفلية في أسفل الصفحة.
builder.Write("This text will be referenced by a footnote.");
builder.InsertFootnote(FootnoteType.Footnote, "Footnote comment regarding referenced text.");

// أدخل المزيد من النص وقم بتمييزه بتعليق ختامي بعلامة مرجعية مخصصة ،
// التي سيتم استخدامها بدلاً من الرقم "2" وتعيين "IsAuto" على خطأ.
builder.Write("This text will be referenced by an endnote.");
builder.InsertFootnote(FootnoteType.Endnote, "Endnote comment regarding referenced text.", "CustomMark");

// تظهر الحواشي السفلية دائمًا في الجزء السفلي من النص المشار إليه ،
// لذلك لن يؤثر فاصل الصفحة هذا على الحاشية السفلية.
// من ناحية أخرى ، تكون التعليقات الختامية دائمًا في نهاية المستند
// بحيث يدفع فاصل الصفحة هذا التعليق الختامي لأسفل إلى الصفحة التالية.
builder.InsertBreak(BreakType.PageBreak);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertFootnote.docx");

يوضح كيفية إدراج الحواشي السفلية وتخصيصها.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أضف نصًا ، وقم بالإشارة إليه بحاشية سفلية. ستضع هذه الحاشية السفلية مرجعًا صغيرًا مرتفعًا
// علامة بعد النص الذي يشير إليه وإنشاء إدخال أسفل النص الأساسي الرئيسي في أسفل الصفحة.
// سيحتوي هذا الإدخال على العلامة المرجعية للحاشية السفلية والنص المرجعي ،
// التي سنمررها إلى طريقة "InsertFootnote" الخاصة بمنشئ المستندات.
builder.Write("Main body text.");
Footnote footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

// إذا تم تعيين هذه الخاصية على "true" ، فإن العلامة المرجعية للحاشية السفلية الخاصة بنا
// سيكون فهرسها بين جميع الحواشي السفلية للقسم.
// هذه هي الحاشية الأولى ، لذا فإن العلامة المرجعية ستكون "1".
Assert.True(footnote.IsAuto);

// يمكننا نقل منشئ المستند داخل الحاشية السفلية لتحرير نصه المرجعي. 
builder.MoveTo(footnote.FirstParagraph);
builder.Write(" More text added by a DocumentBuilder.");
builder.MoveToDocumentEnd();

Assert.AreEqual("\u0002 Footnote text. More text added by a DocumentBuilder.", footnote.GetText().Trim());

builder.Write(" More main body text.");
footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

// يمكننا تعيين علامة مرجعية مخصصة ستستخدمها الحاشية السفلية بدلاً من رقم الفهرس الخاص بها.
footnote.ReferenceMark = "RefMark";

Assert.False(footnote.IsAuto);

// ستظل الإشارة المرجعية مع تعيين علامة "IsAuto" على "صواب" تظهر فهرسها الحقيقي
// حتى إذا كانت الإشارات المرجعية السابقة تعرض علامات مرجعية مخصصة ، فإن العلامة المرجعية لهذه الإشارة المرجعية ستكون "3".
builder.Write(" More main body text.");
footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

Assert.True(footnote.IsAuto);

doc.Save(ArtifactsDir + "InlineStory.AddFootnote.docx");

أنظر أيضا