การทำงานกับสารบัญ

บ่อยครั้งที่คุณจะทำงานกับเอกสารที่มีสารบัญ(TOC) โดยใช้Aspose.Wordsคุณสามารถแทรกตารางเนื้อหาของคุณเองหรือสร้างตารางเนื้อหาที่มีอยู่ในเอกสารโดยใช้เพียงไม่กี่บรรทัดของรหัส.

บทความนี้แสดงวิธีการทำงานกับตารางของฟิลด์เนื้อหาและสาธิต:

• วิธีการแทรกแบรนด์ใหม่TOC.
• อัปเดตใหม่หรือที่มีอยู่TOCsในเอกสาร.
• ระบุสวิตช์เพื่อควบคุมการจัดรูปแบบและโครงสร้างโดยรวมของTOC.
• วิธีการปรับเปลี่ยนรูปแบบและลักษณะของสารบัญ.
• วิธีการลบฟิลด์TOCทั้งหมดพร้อมกับรายการทั้งหมดจากเอกสาร.

แทรกสารบัญทางโปรแกรม

คุณสามารถแทรกฟิลด์TOC(สารบัญ)ลงในเอกสารที่ตำแหน่งปัจจุบันโดยการเรียกวิธีการInsertTableOfContents.

ตารางของเนื้อหาในเอกสารคำสามารถสร้างขึ้นในหลายวิธีและจัดรูปแบบโดยใช้ตัวเลือ สลับฟิลด์ที่คุณส่งผ่านไปยังวิธีการควบคุมวิธีการสร้างตารางและแสดงในเอกสารของคุณ.

สวิตช์ดีฟอลต์ที่ใช้ในTOCแทรกในMicrosoft Wordคือ**"\o “1-3 \h \z \u”** คำอธิบายของสวิทช์เหล่านี้เช่นเดียวกับรายการของสวิทช์ที่สนับสนุนสามารถพบได้ในภายห คุณสามารถใช้คู่มือนั้นเพื่อขอรับสวิตช์ที่ถูกต้องหรือถ้าคุณมีเอกสารที่มีTOCคล้ายกันที่คุณต้องการคุณสามารถแสดงรหัสฟิลด์(*ALT+F9*)และคัดลอกสวิตช์โดยตรงจากฟิลด์.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกตารางของสารบัญฟิลด์ลงในเอกสาร:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a table of contents at the beginning of the document.
builder.insertTableOfContents("\\o \"1-3\" \\h \\z \\u");

// The newly inserted table of contents will be initially empty.
// It needs to be populated by updating the fields in the document.
doc.updateFields();

doc.save(dataDir + "InsertATableOfContentsField_out.docx");

ตัวอย่างรหัสต่อไปนี้สาธิตวิธีการแทรกสารบัญ(TOC)ลงในเอกสารโดยใช้ลักษณะหัวเรื่องเป็นรา:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();

// Create a document builder to insert content with into document.
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a table of contents at the beginning of the document.
builder.insertTableOfContents("\\o \"1-3\" \\h \\z \\u");

// Start the actual document content on the second page.
builder.insertBreak(BreakType.PAGE_BREAK);

// Build a document with complex structure by applying different heading styles thus creating TOC entries.
builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);

builder.writeln("Heading 1");

builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);

builder.writeln("Heading 1.1");
builder.writeln("Heading 1.2");

builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_1);

builder.writeln("Heading 2");
builder.writeln("Heading 3");

builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);

builder.writeln("Heading 3.1");

builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_3);

builder.writeln("Heading 3.1.1");
builder.writeln("Heading 3.1.2");
builder.writeln("Heading 3.1.3");

builder.getParagraphFormat().setStyleIdentifier(StyleIdentifier.HEADING_2);

builder.writeln("Heading 3.2");
builder.writeln("Heading 3.3");

// Call the method below to update the TOC.
doc.updateFields();

doc.save(dataDir + "InsertATableOfContentsUsingHeadingStyles_out.docx");

รหัสแสดงให้เห็นถึงตารางใหม่ของเนื้อหาจะถูกแทรกลงในเอกสารที่ว่างเปล่า จากนั้นคลาสDocumentBuilderจะถูกใช้เพื่อแทรกการจัดรูปแบบเนื้อหาตัวอย่างที่มีลักษณะหัวเรื่องที่เหมาะสมซึ่งใช้เพื่อทำเครื่องหมายเนื้อหาที่จะรวมอยู่ในTOC บรรทัดถัดไปแล้วเติมTOCโดยการอัปเดตฟิลด์และเค้าโครงหน้าของเอกสาร.

ถ้าไม่มีวิธีที่ใช้ในตัวอย่างเมื่อคุณเปิดเอกสารออกคุณจะพบฟิลด์TOCแต่ไม่มีเนื้อหาที่มองเห็นได้ นี้เป็นเพราะฟิลด์TOCถูกแทรกแต่ยังไม่มีประชากรจนกว่าจะมีการอัปเดตในเอกสาร ข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้จะกล่าวถึงในส่วนถัดไป.

ปรับปรุงสารบัญ

Aspose.Wordsช่วยให้คุณสามารถปรับปรุงอย่างสมบูรณ์TOCที่มีเพียงไม่กี่บรรทัดของรหัส นี้สามารถทำได้เพื่อเติมใหม่แทรกTOCหรืออัปเดตที่มีอยู่TOCหลังจากการเปลี่ยนแปลงเอกสารได้.

ต้องใช้สองวิธีต่อไปนี้เพื่ออัพเดตฟิลด์TOCในเอกสาร:

1. Document.updateFields()
2. Document.updatePageLayout()

โปรดทราบว่าทั้งสองวิธีการปรับปรุงจะต้องถูกเรียกในลำดับที่ ถ้าย้อนกลับตารางของเนื้อหาจะถูกป้อนข้อมูลแต่จะไม่มีหมายเลขหน้าจะปรากฏ สามารถอัปเดตจำนวนของTOCsที่แตกต่างกัน วิธีการเหล่านี้จะอัปเดตTOCsทั้งหมดที่พบในเอกสารโดยอัตโนมัติ.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการสร้างเขตข้อมูลTOCในเอกสารโดยเรียกใช้การปรับปรุงฟิลด์:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
doc.updateFields();

การโทรครั้งแรกที่Document.updateFields()จะสร้างTOC,รายการข้อความทั้งหมดมีประชากรและTOCจะปรากฏเกือบเสร็จ สิ่งเดียวที่ขาดหายไปคือหมายเลขหน้าซึ่งตอนนี้จะแสดงด้วย"?".

สายที่สองไปยังDocument.updatePageLayout()จะสร้างเค้าโครงของเอกสารในหน่วยความจำ การตลาดทางอินเทอร์เน็ต,การขาย,การตลาด,การโฆษณา,รายชื่อผู้มุ่งหวัง หมายเลขหน้าที่ถูกต้องคำนวณจากสายนี้จะถูกแทรกลงในTOC.

ใช้สวิตช์เพื่อควบคุมสารบัญลักษณะการทำงาน

เช่นเดียวกับฟิลด์อื่นๆฟิลด์TOCสามารถยอมรับสวิตช์ที่กำหนดไว้ภายในโค้ดฟิลด์ที่ควบคุมวิธีการส สวิตช์บางอย่างใช้เพื่อควบคุมรายการที่จะถูกรวมและที่ระดับใดในขณะที่คนอื่นๆจะใช้ในการควบคุมลักษณะที่ปรากฏของTOC สวิทช์สามารถรวมเข้าด้วยกันเพื่อให้ตารางที่ซับซ้อนของเนื้อหาที่จะผลิต.

โดยค่าเริ่มต้นสวิตช์เหล่านี้ข้างต้นจะรวมอยู่เมื่อใส่ค่าเริ่มต้นTOCในเอกสาร TOCที่ไม่มีสวิตช์จะรวมถึงเนื้อหาจากรูปแบบส่วนหัวในตัว(ราวกับว่าสวิตช์\โอถูกตั้งค่า).

สวิตช์ที่มีอยู่TOCที่ได้รับการสนับสนุนโดยAspose.Wordsจะแสดงรายการด้านล่างและการใช้งานของสวิทช์ พวกเขาสามารถแบ่งออกเป็นส่วนที่แยกต่างหากขึ้นอยู่กับประเภทของพวกเขา สวิตช์ในส่วนแรกกำหนดเนื้อหาที่จะรวมในTOCและสวิตช์ในส่วนที่สองควบคุมลักษณะที่ปรากฏของTOC.

ถ้าสวิตช์ไม่อยู่ในรายการที่นี่แล้วมันจะไม่ได้รับการสนับสนุนในขณะนี้ สวิทช์ทั้งหมดจะได้รับการสนับสนุนในรุ่นอนาคต เราจะเพิ่มการสนับสนุนเพิ่มเติมเพื่อให้ทุกรุ่น.

สวิตช์การทำเครื่องหมายรายการ

สวิตช์	การบรรจุ
Heading Styles (สวิตช์\โอ)	สวิตช์นี้กำหนดว่าTOCควรสร้างขึ้นจากลักษณะหัวเรื่องในตัว ในMicrosoft Wordเหล่านี้ถูกกำหนดโดยHeading 1–Heading 9 ในAspose.Wordsลักษณะเหล่านี้จะแสดงโดยการแจงนับStyleIdentifierที่สอดคล้องกัน การแจงนับนี้แสดงตัวระบุแบบโลแคลของสไตล์ตัวอย่างเช่นStyleIdentifier.Heading1แสดงถึงสไตล์Heading 1 รจัดรูปแบบและคุณสมบัติของสไตล์สามารถดึงข้อมูลได้จากคอลเล็กชันสไตล์ของเอกสาร คลาสสไตล์ที่สอดคล้องกันสามารถดึงข้อมูลจากคอลเลกชันDocument.Stylesโดยใช้คุณสมบัติการทำดัชนีของชนิดStyleIdentifier เนื้อหาใดๆที่จัดรูปแบบด้วยรูปแบบเหล่านี้จะรวมอยู่ในตารางของเนื้อหา ระดับของส่วนหัวจะกำหนดระดับลำดับชั้นที่สอดคล้องกันของรายการในTOC ตัวอย่างเช่นย่อหน้าที่มีสไตล์Heading 1จะถือว่าเป็นระดับแรกในTOCในขณะที่ย่อหน้าที่มีHeading 2จะถือว่าเป็นระดับถัดไปในลำดับชั้นและอื่นๆ
Outline Levels (\Uสวิตช์)	แต่ละย่อหน้าสามารถกำหนดระดับเค้าร่างภายใต้ตัวเลือกย่อหน้า การตั้งค่านี้กำหนดระดับย่อหน้านี้ควรได้รับการปฏิบัติในลำดับชั้นของเอกสาร นี่คือการปฏิบัติที่ใช้กันทั่วไปที่ใช้ในการจัดโครงสร้างโครงร่างของเอกสาร ลำดับชั้นนี้สามารถดูได้โดยการเปลี่ยนเป็นมุมมองเค้าร่างในMicrosoft Word คล้ายกับรูปแบบหัวเรื่องสามารถมีระดับเค้าร่าง 1-9 นอกเหนือไปจาก"ข้อความร่างกาย"ระดั ระดับเค้าร่าง 1–9 จะปรากฏในTOCในระดับที่สอดคล้องกันของลำดับชั้น เนื้อหาใดๆที่มีระดับเค้าร่างที่กำหนดไว้ในสไตล์ย่อหน้าหรือโดยตรงในย่อหน้าจะรวมอยู่ในTOC ในAspose.Wordsระดับเค้าร่างจะแสดงโดยคุณสมบัติParagraphFormat.OutlineLevelของโหนดย่อหน้า ระดับเค้าร่างของสไตล์ย่อหน้าจะแสดงในลักษณะเดียวกันโดยคุณสมบัติStyle.ParagraphFormat โปรดทราบว่ารูปแบบส่วนหัวในตัวเช่นHeading 1มีระดับเค้าร่างบังคับตั้งค่าในการตั้งค่าลักษณะ
Custom Styles (\Tสวิตช์)	สวิตช์นี้จะอนุญาตให้ใช้รูปแบบที่กำหนดเองเมื่อมีการรวบรวมรายการที่จะใช้ในการTOC มักจะใช้ร่วมกับสวิตช์\โอที่จะรวมรูปแบบที่กำหนดเองพร้อมกับรูปแบบหัวเรื่องในตัวในTOC พารามิเตอร์ของสวิทช์ควรอยู่ภายในเครื่องหมายคำพูด Stylesระบุชื่อตามด้วยเครื่องหมายจุลภาคตามด้วยระดับที่สไตล์ควรจะปรากฏในTOCเป็น อ้างอิงแก้ไข ตัวอย่างเช่น { TOC \o "1-3" \t "CustomHeading1, 1, CustomHeading2, 2"} จะใช้เนื้อหาสไตล์ด้วยCustomHeading1เป็นระดับ 1 เนื้อหาในTOCและCustomHeading2เป็นระดับ 2
ใช้ฟิลด์ TC (สวิตช์ \F และ \L)	ในเวอร์ชันเก่าของ Microsoft Word วิธีเดียวที่จะสร้าง TOC ได้คือการใช้ฟิลด์ TC ฟิลด์เหล่านี้จะถูกแทรกซ่อนไว้ในเอกสารแม้ว่าจะมีการแสดงโค้ดฟิลด์ก็ตาม ฟิลด์เหล่านี้รวมข้อความที่ควรจะแสดงในรายการและ TOC จะถูกสร้างขึ้นจากโค้ดเหล่านี้ ฟังก์ชันนี้ไม่ค่อยได้ใช้บ่อยนักในปัจจุบัน แต่ยังคงมีประโยชน์ในบางโอกาสเพื่อรวมรายการใน TOC ที่ไม่ได้ย่อหน้าเพื่อให้มองเห็นได้ในเอกสาร เมื่อแทรกฟิลด์เหล่านี้จะปรากฏเป็นซ่อนอยู่ แม้ว่าจะแสดงรหัสฟิลด์ก็ตาม ไม่สามารถมองเห็นได้หากไม่แสดงเนื้อหาที่ซ่อนอยู่ หากต้องการดูฟิลด์เหล่านี้ จะต้องเลือกการจัดรูปแบบย่อหน้า คุณสามารถแทรกฟิลด์เหล่านี้ลงในเอกสารได้ทุกตำแหน่ง เช่นเดียวกับฟิลด์อื่นๆ และแสดงด้วยการแจงนับ FieldType.FieldTOCEntry สวิตช์ \F ใน TOC ใช้เพื่อระบุว่าควรใช้ฟิลด์ TC เป็นรายการ สวิตช์ที่ไม่มีตัวระบุพิเศษใดๆ หมายความว่าฟิลด์ TC ใดๆ ในเอกสารจะถูกรวมไว้ พารามิเตอร์พิเศษใดๆ ซึ่งมักจะเป็นตัวอักษรเพียงตัวเดียว จะระบุว่าเฉพาะฟิลด์ TC ที่มีสวิตช์ \f ที่ตรงกันเท่านั้นที่จะรวมอยู่ใน TOC ตัวอย่างเช่น { TOC \f t } จะรวมเฉพาะฟิลด์ TC เช่น { TC \f t } ฟิลด์ TOC ยังมีสวิตช์ที่เกี่ยวข้องอีกด้วย สวิตช์ “\L” ระบุว่าจะรวมเฉพาะฟิลด์ TC ที่มีระดับภายในช่วงที่ระบุเท่านั้น ฟิลด์ TC เองสามารถตั้งค่าสวิตช์ {several, multiple, a few, many, numerous} ได้ ดังต่อไปนี้: - \F – อธิบายไว้ข้างต้น - \L – กำหนดว่าฟิลด์ TC นี้จะปรากฏในระดับใดใน TOC TOC ที่ใช้สวิตช์เดียวกันนี้จะรวมฟิลด์ TC เฉพาะในกรณีที่อยู่ในช่วงที่ระบุเท่านั้น - _\N – ไม่แสดงหมายเลขหน้าสำหรับรายการ TOC นี้ ตัวอย่างรหัสวิธีการแทรกฟิลด์ TC สามารถพบได้ในหัวข้อถัดไป

สวิตช์ที่เกี่ยวข้องกับลักษณะที่ปรากฏ

สวิตช์	การบรรจุ
Omit Page Numbers (\Nสวิตช์)	สวิตช์นี้ใช้เพื่อซ่อนหมายเลขหน้าสำหรับบางระดับของTOC ตัวอย่างเช่นคุณสามารถกำหนด {TOC \o "1-4" \n "3-4" } และหมายเลขหน้าในรายการของระดับ 3 และสี่จะถูกซ่อนไว้พร้อมกับจุดผู้นำ(ถ้ามี) เมื่อต้องการระบุเพียงหนึ่งระดับช่วงควรจะยังคงใช้ตัวอย่างเช่น"1-1"จะไม่รวมหมายเลขห การจัดหาช่วงระดับจะละเว้นหมายเลขหน้าสำหรับทุกระดับในTOC นี้จะเป็นประโยชน์ในการตั้งค่าเมื่อเอ็กซ์ปอร์ตเอกสารไปยังHTMLหรือรูปแบบที่คล้ายกัน นี้เป็นเพราะHTMLรูปแบบตามไม่ได้มีแนวคิดหน้าใดๆและจึงไม่จำเป็นต้องมีหมายเลขหน้าใดๆ
แทรกเป็นการเชื่อมโยงหลายมิติ (สวิตช์\ชม.)	สวิตช์นี้ระบุว่าTOCรายการถูกแทรกเป็นไฮเปอร์ลิงค์ เมื่อดูเอกสารในMicrosoft Wordรายการเหล่านี้จะยังคงปรากฏเป็นข้อความปกติภายในTOCแต่มีการเชื่อมโยงหลายมิติจึงสามารถใช้เพื่อนำทางไปยังตำแหน่งของรายการต้นฉบับในเอกสารโดยใช้Ctrl + Left ClickในMicrosoft Word ล่านี้จะถูกเก็บรักษาไว้ในรูปแบบอื่นๆ ตัวอย่างเช่นในHTMLรูปแบบรวมถึงEPUBและรูปแบบที่แสดงผลเช่นPDFและXPSจะถูกเอ็กซ์ปอร์ตเป็นลิงก์ที่ท โดยไม่มีชุดสวิตช์นี้,TOCในเอาต์พุตทั้งหมดเหล่านี้จะถูกส่งออกเป็นข้อความธรรมดาและจะไม่แส ถ้าเอกสารถูกเปิดในMSคำข้อความของรายการจะไม่สามารถคลิกได้ด้วยวิธีนี้แต่หมายเลข
Set Separator Character (\P สวิตช์)	สวิตช์นี้ช่วยให้เนื้อหาแยกชื่อเรื่องของรายการและหมายเลขหน้าได้อย่างง่ายดายในTOC ควรระบุตัวคั่นที่จะใช้หลังจากสวิตช์นี้และอยู่ในเครื่องหมายคำพูด ขัดกับสิ่งที่เป็นเอกสารในเอกสารสำนักงาน,เพียงหนึ่งอักขระสามารถใช้แทนถึงห้า. นี้ใช้กับทั้งMSคำและAspose.Words ไม่แนะนำให้ใช้สวิตช์นี้เนื่องจากไม่อนุญาตให้ควบคุมสิ่งที่ใช้เพื่อแยกรายการและหมายเลขหน้าในTOC แต่ขอแนะนำให้แก้ไขสไตล์ที่เหมาะสมTOCเช่นStyleIdentifier.TOC1และจากนั้นแก้ไขสไตล์ผู้นำที่มีการเข้าถึงสมาชิกแบบอักษรที่เฉพาะเจาะจงฯลฯ รายละเอียดเพิ่มเติมของวิธีการทำเช่นนี้สามารถพบได้ในภายหลังในบทความ
Preserve Tab Entries (\W สวิตช์)	การใช้สวิตช์นี้จะเป็นการระบุว่ารายการใดๆที่มีอักขระแท็บเช่นหัวข้อที่มีแท็บที่ท้ายบรรทัดจะถูกเก็บไว้เป็นอักขระแท็บที่เหมาะสมเมื่อเติมTOC ซึ่งหมายความว่าฟังก์ชันของอักขระแท็บจะถูกแสดงในTOCและสามารถใช้ฟอร์แมตรายการได้ ตัวอย่างเช่นรายการบางรายการอาจใช้แท็บหยุดและอักขระแท็บเพื่อเว้นวรรคข้อความอ ตราบใดที่ระดับTOCที่สอดคล้องกันกำหนดแท็บเทียบเท่าหยุดแล้วTOCรายการที่สร้างขึ้นจะปรากฏ ในสถานการณ์เดียวกันถ้าสวิตช์นี้ไม่ได้กำหนดแล้วอักขระแท็บจะถูกแปลงเป็นเทียบเท่าพื้น ผลลัพธ์จะไม่ปรากฏตามที่คาดไว้
Preserve New Line Entries (\สวิตช์ X)	คล้ายกับสวิตช์ด้านบนสวิตช์นี้ระบุว่าส่วนหัวที่ทอดผ่านหลายบรรทัด(โดยใช้อักขระบรรทัดใหม่ไม่ใช่ย่อหน้าแยกต่างหาก)จะถูกเก็บรักษาไว้ตามที่อยู่ในที่สร้างTOC หรือControlChar.LineBreak)เพื่อแยกเนื้อหาข้ามบรรทัดต่างกัน ด้วยสวิตช์นี้ที่ระบุไว้รายการในTOCจะเก็บอักขระบรรทัดใหม่เหล่านี้ไว้ตามที่แสดงด้านล่าง ในสถานการณ์เช่นนี้ถ้าสวิทช์ไม่ได้กำหนดไว้แล้วอักขระบรรทัดใหม่จะถูกแปลงเป็นพื้นที่สีข

แทรกฟิลด์TC

คุณสามารถแทรกฟิลด์TCใหม่ที่ตำแหน่งปัจจุบันของDocumentBuilderโดยเรียกวิธีการDocumentBuilder.InsertFieldและระบุชื่อฟิลด์เป็น"TC"พร้อมกับสวิทช์ใดๆที่จำเป็น.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการแทรกฟิลด์TCลงในเอกสารโดยใช้DocumentBuilder.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();

// Create a document builder to insert content with.
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a TC field at the current document builder position.
builder.insertField("TC \"Entry Text\" \\f t");

มักจะมีการกำหนดบรรทัดข้อความเฉพาะสำหรับ TOC และทำเครื่องหมายด้วยฟิลด์ TC วิธีง่ายๆ ในการทำเช่นนี้ใน Word MS คือ ไฮไลต์ข้อความแล้วกด ALT+SHIFT+O วิธีนี้จะสร้างฟิลด์ TC โดยอัตโนมัติโดยใช้ข้อความที่เลือก เทคนิคเดียวกันนี้สามารถทำได้โดยใช้โค้ด โค้ดด้านล่างนี้จะค้นหาข้อความที่ตรงกับอินพุตและแทรกฟิลด์ TC ในตำแหน่งเดียวกับข้อความ โค้ดนี้ใช้เทคนิคเดียวกับที่ใช้ในบทความ ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีค้นหาและแทรกฟิลด์ TC ในข้อความในเอกสาร.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
class InsertTCFieldHandler implements IReplacingCallback {
    // Store the text and switches to be used for the TC fields.
    private String mFieldText;
    private String mFieldSwitches;

    /**
     * The switches to use for each TC field. Can be an empty string or null.
     */
    public InsertTCFieldHandler(String switches) throws Exception {
        this(null, switches);
    }

    /**
     * The display text and the switches to use for each TC field. Display text
     * Can be an empty string or null.
     */
    public InsertTCFieldHandler(String text, String switches) throws Exception {
        mFieldText = text;
        mFieldSwitches = switches;
    }

    public int replacing(ReplacingArgs args) throws Exception {
        // Create a builder to insert the field.
        DocumentBuilder builder = new DocumentBuilder((Document) args.getMatchNode().getDocument());
        // Move to the first node of the match.
        builder.moveTo(args.getMatchNode());

        // If the user specified text to be used in the field as display text then use that, otherwise use the
        // match string as the display text.
        String insertText;

        if (!(mFieldText == null || "".equals(mFieldText)))
            insertText = mFieldText;
        else
            insertText = args.getMatch().group();

        // Insert the TC field before this node using the specified string as the display text and user defined switches.
        builder.insertField(java.text.MessageFormat.format("TC \"{0}\" {1}", insertText, mFieldSwitches));

        // We have done what we want so skip replacement.
        return ReplaceAction.SKIP;
    }

}

แก้ไขสารบัญ

เปลี่ยนรูปแบบของรูปแบบ

การจัดรูปแบบของรายการในTOCไม่ได้ใช้สไตล์ดั้งเดิมของรายการที่ทำเครื่องหมายไว้แต่ละระดับจะถูกจัดรูปแบบโดยใช้สไตล์ที่เทียบเท่าTOC ตัวอย่างเช่นระดับแรกในTOCถูกจัดรูปแบบด้วยสไตล์TOC1ระดับที่สองจัดรูปแบบด้วยสไตล์TOC2และอื่นๆ ลี่ยนรูปลักษณ์ของTOCลักษณะเหล่านี้ต้องถูกแก้ไข ในAspose.Wordsลักษณะเหล่านี้จะแสดงโดยโลแคลอิสระStyleIdentifier.TOC1ถึงStyleIdentifier.TOC9และสามารถดึงข้อมูลจากคอลเล็กชันDocument.Stylesโดยใ.

เมื่อมีการดึงข้อมูลลักษณะที่เหมาะสมของเอกสารแล้วการจัดรูปแบบสำหรับลักษณะนี้สามา การเปลี่ยนแปลงลักษณะเหล่านี้จะปรากฏขึ้นโดยอัตโนมัติในTOCsในเอกสาร.

ตัวอย่างรหัสต่อไปนี้จะเปลี่ยนคุณสมบัติการจัดรูปแบบที่ใช้ในลักษณะระดับแรกTOC.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
public static void changeAFormattingPropertyUsedInFirstLevelTOCStyle() throws Exception {
    Document doc = new Document();
    // Retrieve the style used for the first level of the TOC and change the formatting of the style.
    doc.getStyles().getByStyleIdentifier(StyleIdentifier.TOC_1).getFont().setBold(true);
}

นอกจากนี้ยังเป็นประโยชน์ที่จะทราบว่าการจัดรูปแบบโดยตรงของย่อหน้า(ที่กำหนดไว้ในย่อหน้าเองและไม่ได้อยู่ในสไตล์)ที่ทำเครื่องหมายไว้ในTOCจะถูกคัดลอกในรายการในTOC ตัวอย่างเช่นหากใช้สไตล์Heading 1เพื่อทำเครื่องหมายเนื้อหาสำหรับTOCและสไตล์นี้มีการจัดรูปแบบตัวหนา รายการผลลัพธ์TOCจะไม่เป็นตัวหนาเนื่องจากเป็นส่วนหนึ่งของการจัดรูปแบบสไตล์แต่จะเอียงเนื่องจากมีการจัดรูปแบบโดยตรงในย่อหน้า.

นอกจากนี้คุณยังสามารถควบคุมการจัดรูปแบบของตัวคั่นที่ใช้ระหว่างแต่ละรายการและหม โดยค่าเริ่มต้น,นี้เป็นเส้นประที่กระจายไปทั่วไปยังหมายเลขหน้าโดยใช้อักขระแท็บและหยุด.

การใช้ชั้นเรียนStyleที่ดึงสำหรับระดับTOCเฉพาะที่คุณต้องการปรับเปลี่ยนคุณยังสามารถปรับเปลี่ย.

เมื่อต้องการเปลี่ยนวิธีการนี้ปรากฏขึ้นในตอนแรกStyle.ParagraphFormatต้องถูกเรียกใช้เพื่อเรียกการจัดรูปแบบย่อหน้าสำหรับสไตล์ จากนี้แท็บหยุดสามารถเรียกดูได้โดยเรียกParagraphFormat.TabStopsและแท็บหยุดที่เหมาะสมแก้ไข ใช้เทคนิคเดียวกันนี้แท็บตัวเองสามารถย้ายหรือลบออกโดยสิ้นเชิง.

ตัวอย่างรหัสต่อไปนี้แสดงวิธีการปรับเปลี่ยนตำแหน่งของแท็บขวาหยุดในย่อหน้าที่เกี่ยวข้องTOC.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
public static void modifyPositionOfRightTabStopInTOC() throws Exception {
    Document doc = new Document(dataDir + "Field.TableOfContents.doc");

    // Iterate through all paragraphs in the document
    for (Paragraph para : (Iterable<Paragraph>) doc.getChildNodes(NodeType.PARAGRAPH, true)) {
        // Check if this paragraph is formatted using the TOC result based styles. This is any style between TOC and TOC9.
        if (para.getParagraphFormat().getStyle().getStyleIdentifier() >= StyleIdentifier.TOC_1 && para.getParagraphFormat().getStyle().getStyleIdentifier() <= StyleIdentifier.TOC_9) {
            // Get the first tab used in this paragraph, this should be the tab used to align the page numbers.
            TabStop tab = para.getParagraphFormat().getTabStops().get(0);
            // Remove the old tab from the collection.
            para.getParagraphFormat().getTabStops().removeByPosition(tab.getPosition());
            // Insert a new tab using the same properties but at a modified position.
            // We could also change the separators used (dots) by passing a different Leader type
            para.getParagraphFormat().getTabStops().add(tab.getPosition() - 50, tab.getAlignment(), tab.getLeader());
        }
    }

    doc.save(dataDir + "Field.TableOfContentsTabStops_Out.doc");
}

นำสารบัญออกจากเอกสาร

สารบัญสามารถลบออกจากเอกสารโดยการลบโหนดทั้งหมดที่พบระหว่างFieldStartและFieldEndโหนดของTOC.

รหัสด้านล่างแสดงให้เห็นถึงนี้ การกำจัดของฟิลด์TOCจะง่ายกว่าฟิลด์ปกติเนื่องจากเราไม่ได้ติดตามเขตข้อมูลที่ซ้อนกัน แต่เราตรวจสอบFieldEndโหนดเป็นประเภทFieldType.FieldTOCซึ่งหมายความว่าเราได้พบจุดสิ้นสุดของปัจจุบันTOC เทคนิคนี้สามารถใช้ในกรณีนี้โดยไม่ต้องกังวลเกี่ยวกับเขตข้อมูลที่ซ้อนกันใดๆที่เราสามารถสมมติว่าเอกสารใดๆที่เกิดขึ้นอย่างถูกต้องจะไม่มีเขตข้อมูลที่ซ้อนกันอย่างเต็มที่TOCภายในอีกเขตข้อมูลTOC.

ประการแรกFieldStartโหนดของแต่ละTOCจะถูกรวบรวมและเก็บไว้ จากนั้นTOCที่ระบุจะถูกแจกแจงเพื่อให้โหนดทั้งหมดภายในฟิลด์ถูกเยี่ยมชมและเก็บไว้ จากนั้นโหนดจะถูกลบออกจากเอกสาร ตัวอย่างรหัสต่อไปนี้สาธิตวิธีการลบTOCที่ระบุจากเอกสาร.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// Open a document which contains a TOC.
Document doc = new Document(dataDir + "Document.TableOfContents.doc");

// Remove the first table of contents from the document.
removeTableOfContents(doc, 0);

// Save the output.
doc.save(dataDir + "Document.TableOfContentsRemoveToc_Out.doc");

สารสกัดจากสารบัญ

ถ้าคุณต้องการแยกสารบัญจากเอกสารคำใดๆสามารถใช้ตัวอย่างรหัสต่อไปนี้ได้.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
      String dataDir = Utils.getSharedDataDir(ExtractTableOfContents.class) + "TableOfContents/";

      String fileName = "TOC.doc";
      Document doc = new Document(dataDir + fileName);
      
      for (Field field : (Iterable<Field>)doc.getRange().getFields())
      {
          if (field.getType() == FieldType.FIELD_HYPERLINK)
          {
              FieldHyperlink hyperlink = (FieldHyperlink)field;
              if (hyperlink.getSubAddress() != null && hyperlink.getSubAddress().startsWith("_Toc"))
              {
                  Paragraph tocItem = (Paragraph)field.getStart().getAncestor(NodeType.PARAGRAPH);
                  System.out.println(tocItem.toString(SaveFormat.TEXT).trim());
                  System.out.println("------------------");
                  if (tocItem != null)
                  {
                      Bookmark bm = doc.getRange().getBookmarks().get(hyperlink.getSubAddress());
                      // Get the location this TOC Item is pointing to
                      Paragraph pointer = (Paragraph)bm.getBookmarkStart().getAncestor(NodeType.PARAGRAPH);
                      System.out.println(pointer.toString(SaveFormat.TEXT));
                  }
              } // End If
          }// End If
      }// End Foreach