วิธีทำงานกับ Sections ใน .NET

ขั้นตอนที่ 1: ติดตั้งแพ็กเกจ

Aspose.Words FOSS for .NET ยังไม่ได้เผยแพร่แพ็กเกจ NuGet – ให้สร้างไลบรารีจากซอร์สโค้ดแทน. คัดลอก https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, จากนั้นสร้าง Aspose.Words.sln ในโหมด Release ด้วย .NET SDK และอ้างอิง assembly Aspose.Words ที่สร้างขึ้นจากโครงการของคุณ. ไลบรารีนี้ตั้งเป้าหมายที่ .NET Standard 2.0, ดังนั้นจึงทำงานบน .NET Framework 4.6.2+ และ .NET 6/8/10.

ขั้นตอนที่ 2: นำเข้าคลาสที่จำเป็น

เพิ่มคำสั่ง using Aspose.Words; – Section, PageSetup, HeaderFooter, และ enum ที่เกี่ยวข้องที่ใช้ในคู่มือนี้ทั้งหมดอยู่โดยตรงใน namespace Aspose.Words ควบคู่กับ Document และ DocumentBuilder.

ขั้นตอนที่ 3: อ่านส่วนที่มีอยู่แล้วในเอกสาร

Document.Sections ส่งคืน SectionCollection ที่เก็บทุก Section ในเอกสาร, แต่ละอันเป็น CompositeNode ซึ่งเป็นส่วนหนึ่งของโครงสร้างโหนดโดยรวม. Document.FirstSection และ Document.LastSection ให้การเข้าถึงโดยตรงไปยังส่วนขอบโดยไม่ต้องวนรอบคอลเลกชัน. แต่ละ Section มี Body หนึ่งรายการ – เข้าถึงได้เช่นเดียวกับ Story ใด ๆ – และเมื่อมี, เนื้อหาส่วนหัวและส่วนท้ายสามารถเข้าถึงได้ผ่าน Section.HeadersFooters.

ขั้นตอนที่ 4: เริ่มส่วนใหม่ด้วย Section Break

Call DocumentBuilder.InsertBreak(BreakType) ที่ตำแหน่งเคอร์เซอร์เพื่อเริ่มส่วนใหม่. ส่ง BreakType.SectionBreakNewPage เมื่อส่วนใหม่ควรเริ่มเสมอบนหน้าว่างใหม่, BreakType.SectionBreakContinuous เมื่อต้องการเพียงการเปลี่ยนแปลงการตั้งค่าหน้าเท่านั้น (เช่น การสลับเป็นข้อความหลายคอลัมน์) โดยไม่บังคับให้มีการแบ่งหน้า, หรือ BreakType.SectionBreakNewColumn, SectionBreakEvenPage, และ SectionBreakOddPage สำหรับพฤติกรรมการเริ่มส่วนอื่นที่ Word รองรับ. การแทรกส่วนจะพาเอาการจัดรูปแบบของส่วนที่ follows ของมัน, ดังนั้นตั้งค่า PageSetup คุณสมบัติบนส่วนใหม่ Section – ไม่ใช่ส่วนก่อนหน้า – ทันทีที่การแทรกส่วนถูกแทรก. DocumentBuilder.MoveToSection(sectionIndex) ย้ายเคอร์เซอร์ไปยังจุดเริ่มต้นของเนื้อหาส่วนเฉพาะ, และ PageSetup.SectionStart อ่านหรือกำหนดค่า SectionStart ประเภทการแทรกส่วนที่บันทึกไว้แล้วในส่วนที่มีอยู่.

ขั้นตอนที่ 5: กำหนดค่าขนาดหน้าและขอบกระดาษ

แต่ละ Section.PageSetup เป็นอินสแตนซ์ของ PageSetup. ตั้งค่า PageWidth, PageHeight, LeftMargin, RightMargin, TopMargin, BottomMargin, และ Gutter สำหรับขนาดหน้าและขอบกระดาษ, หรือกำหนดค่าพรีเซ็ต Margins โดยตรงให้กับ PageSetup.Margins. Orientation และ PaperSize ควบคุมการวางแนวหน้ากระดาษและขนาดกระดาษ. ขอบหน้ากระดาษกำหนดค่าด้วย Borders (ซึ่งเป็น BorderCollection), BorderAppliesTo (PageBorderAppliesTo), BorderDistanceFrom (PageBorderDistanceFrom), BorderAlwaysInFront, BorderSurroundsHeader, และ BorderSurroundsFooter. เรียก PageSetup.ClearFormatting() เพื่อรีเซ็ตการตั้งค่าหน้าของส่วนให้กลับไปเป็นค่าเริ่มต้นก่อนที่จะกำหนดค่าใหม่ตั้งแต่ต้น.

ขั้นตอนที่ 6: เพิ่มและเชื่อมโยงส่วนหัวและส่วนท้าย

Section.HeadersFooters เป็น HeaderFooterCollection ที่มีตัวเข้าถึงแบบพิมพ์ – HeaderPrimary, HeaderFirst, HeaderEven, FooterPrimary, FooterFirst, FooterEven – พร้อมกับ GetByHeaderFooterType() สำหรับการค้นหาโดย HeaderFooterType และ Add() เพื่อเพิ่มรายการใหม่. แต่ละ HeaderFooter เป็น Story, มีแฟล็ก IsHeader และ IsLinkedToPrevious. เปิดใช้งาน PageSetup.DifferentFirstPageHeaderFooter หรือ PageSetup.OddAndEvenPagesHeaderFooter ก่อนการเพิ่มตัวแปรที่สอดคล้องกัน HeaderFirst/FooterFirst หรือ HeaderEven/FooterEven – แฟล็กและตัวแปรจะทำงานร่วมกันเท่านั้น. เรียก HeaderFooterCollection.LinkToPrevious() เพื่อเชื่อมส่วนหัวหรือส่วนท้ายของส่วนใหม่ให้สืบทอดเนื้อหาจากส่วนก่อนหน้า, หรือเพื่อยกเลิกการเชื่อมโยงเพื่อให้ส่วนใหม่เริ่มต้นด้วยเนื้อหาอิสระ.

ขั้นตอนที่ 7: จัดวางข้อความหลักในหลายคอลัมน์

PageSetup.TextColumns คืนค่า TextColumnCollection สำหรับส่วนนั้น. เรียก SetCount() พร้อมจำนวนคอลัมน์ที่ข้อความหลักควรไหลเข้าไป, จากนั้นปรับ EvenlySpaced, Spacing, LineBetween, และ Width เพื่อควบคุมการจัดวางคอลัมน์. เมื่อคอลเลกชันมีมากกว่าหนึ่งคอลัมน์, ตัวอย่าง TextColumn แต่ละอันจะแสดง Width และ SpaceAfter ของตนเอง.

ขั้นตอนที่ 8: ล้างหรือแก้ไขเนื้อหาส่วนเป็นกลุ่ม

Section.AppendContent() และ PrependContent() คัดลอกเนื้อหาข้อความหลักของส่วนอื่นเข้ามาในส่วนนี้; ClearContent() ทำให้เนื้อหาข้อความหลักของส่วนเป็นค่าว่างเป็นกลุ่ม. ClearHeadersFooters() และ DeleteHeaderFooterShapes() ล้างเนื้อหาหัวเรื่องและท้ายเรื่องทั่วทั้งส่วนโดยไม่ลบส่วนนั้นออก.