เชิงอรรถและบันทึกท้าย

เชิงอรรถและบันทึกท้าย

เชิงอรรถและบันทึกท้าย

Aspose.Words FOSS สำหรับ .NET แสดงเชิงอรรถและบันทึกท้ายด้วยคลาสโหนด Footnote เพียงหนึ่งเดียวที่แยกโดยคุณสมบัติ FootnoteType ของมัน, พร้อมกับคลาสตัวเลือกการกำหนดหมายเลขและตัวคั่นแยกต่างหากในเนมสเปซ Aspose.Words.Notes.


การอ่านเนื้อหาเชิงอรรถและบันทึกท้าย

Footnote เป็นโหนดเรื่องแบบผสม — เช่น Body หรือเซลล์ตาราง, มันประกอบด้วย Paragraphs และ Tables — ที่เก็บข้อความของเชิงอรรถหรือบันทึกท้ายหนึ่งรายการ. คุณสมบัติ FootnoteType ของมัน (ค่า enum 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 — แต่ก็สามารถเข้าถึงได้เต็มที่ หากเอกสารต้องการประกาศต่อเนื่องแบบกำหนดเอง.

ปัญหาทั่วไป

ปัญหาสาเหตุการแก้ไข
เชิงอรรถและบันทึกท้ายสับสนในตรรกะการประมวลผลทั้งสองใช้คลาส Footnote เดียวกันแยกสาขาตาม Footnote.FootnoteType
ข้อความเครื่องหมายอ้างอิงไม่ตรงกับผลลัพธ์ที่แสดงใช้ ReferenceMark แทน ActualReferenceMarkอ่าน ActualReferenceMark เพื่อดูเครื่องหมายที่แสดงผล
การนับเลขเริ่มต้นใหม่โดยไม่คาดคิดต่อหน้า/ส่วนRestartRule ถูกตั้งค่าเป็น RestartPage หรือ RestartSectionตั้งค่า RestartRule เป็น Continuous เพื่อการนับเลขทั่วเอกสาร
คอลัมน์เชิงอรรถถูกละเว้นที่ด้านล่างของหน้าFootnoteOptions.Columns ไม่ได้ตั้งค่าตั้งค่า Columns อย่างชัดเจนบน FootnoteOptions

FAQ

ฉันจะบอกว่าเชิงอรรถแตกต่างจากบันทึกท้ายอย่างไรในโค้ด?

ตรวจสอบคุณสมบัติ FootnoteType บนวัตถุ Footnote — มันจะคืนค่า FootnoteType.Footnote หรือ FootnoteType.Endnote.

เชิงอรรถและบันทึกท้ายสามารถมีกฎการจัดลำดับเลขที่ต่างกันได้หรือไม่?

ใช่ — FootnoteOptions และ EndnoteOptions ถูกกำหนดค่าอย่างอิสระ, แต่ละอันมี Position, NumberStyle, StartNumber, และ RestartRule ของตนเอง.

FootnoteSeparator ใช้เพื่ออะไร?

มันเป็นตัวแทนของเนื้อหาที่ Word แทรกเพื่อแยกส่วนหลักของเอกสารจากเชิงอรรถหรือบันทึกท้ายอย่างชัดเจน, และเป็นข้อความแจ้งเมื่อเชิงอรรถต่อเนื่องไปยังหน้าถัดไป.

Footnote รองรับตารางภายในบันทึกหรือไม่?

ใช่ — Footnote เปิดเผยคุณสมบัติ Tables ควบคู่กับ Paragraphs, เนื่องจากเป็นโหนดเรื่องราวเชิงผสมคล้ายกับส่วนหลักของเอกสาร.


API Reference สรุป

คลาส / เมธอดคำอธิบาย
Footnoteโหนดคอนเทนเนอร์สำหรับเนื้อหาของเชิงอรรถหรือเชิงอรรถท้ายหนึ่งรายการ
FootnoteTypeชนิด Enum: Footnote, Endnote
FootnoteOptionsการตั้งค่าการนับเลขและตำแหน่งของเชิงอรรถสำหรับเอกสาร/ส่วน
EndnoteOptionsการตั้งค่าการนับเลขและตำแหน่งของเชิงอรรถท้ายสำหรับเอกสาร/ส่วน
FootnotePosition / EndnotePositionEnums สำหรับการวางตำแหน่ง (BottomOfPage/BeneathText, EndOfSection/EndOfDocument)
FootnoteNumberingRuleEnum ที่ควบคุมว่าเมื่อใดจะรีสตาร์ทการนับเลข
FootnoteSeparatorโหนดเรื่องราวสำหรับเนื้อหาเครื่องหมายคั่นของเชิงอรรถ/เชิงอรรถท้าย
FootnoteSeparatorCollectionการเข้าถึงแบบกำหนดประเภทของโหนด FootnoteSeparator ทั้งหมด
FootnoteSeparatorTypeEnum ที่ระบุว่าตัวโหนดเป็นหนึ่งในหกบทบาทของตัวคั่น

ดูเพิ่มเติม

 ภาษาไทย