เชิงอรรถและบันทึกท้าย
เชิงอรรถและบันทึกท้าย
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 / EndnotePosition | Enums สำหรับการวางตำแหน่ง (BottomOfPage/BeneathText, EndOfSection/EndOfDocument) |
FootnoteNumberingRule | Enum ที่ควบคุมว่าเมื่อใดจะรีสตาร์ทการนับเลข |
FootnoteSeparator | โหนดเรื่องราวสำหรับเนื้อหาเครื่องหมายคั่นของเชิงอรรถ/เชิงอรรถท้าย |
FootnoteSeparatorCollection | การเข้าถึงแบบกำหนดประเภทของโหนด FootnoteSeparator ทั้งหมด |
FootnoteSeparatorType | Enum ที่ระบุว่าตัวโหนดเป็นหนึ่งในหกบทบาทของตัวคั่น |