การทำงานกับสไตล์และธีม
คลาส StyleCollection ใช้เพื่อจัดการในตัวและใช้การตั้งค่าที่ผู้ใช้กำหนดกับสไตล์
การเข้าถึงสไตล์
คุณสามารถรับคอลเลกชั่นสไตล์ที่กำหนดในเอกสารได้โดยใช้คุณสมบัติ Document.styles คอลเลกชันนี้เก็บทั้งสไตล์ในตัวและสไตล์ที่ผู้ใช้กำหนดในเอกสาร สไตล์เฉพาะสามารถรับได้จากชื่อ/นามแฝง ตัวระบุสไตล์ หรือดัชนี ตัวอย่างโค้ดต่อไปนี้สาธิตวิธีการเข้าถึงคอลเลกชันสไตล์ที่กำหนดไว้ในเอกสาร
วิธีแยกเนื้อหาตามสไตล์
ในระดับง่ายๆ การดึงเนื้อหาตามสไตล์จากเอกสาร Word จะมีประโยชน์ในการระบุ แสดงรายการ และนับย่อหน้า และเรียกใช้ข้อความที่จัดรูปแบบด้วยสไตล์เฉพาะ ตัวอย่างเช่น คุณอาจต้องระบุเนื้อหาบางประเภทในเอกสาร เช่น ตัวอย่าง ชื่อเรื่อง ข้อมูลอ้างอิง คำสำคัญ ชื่อรูปภาพ และกรณีศึกษา
หากต้องการดำเนินการเพิ่มเติมอีกสองสามขั้นตอน ยังสามารถใช้เพื่อใช้ประโยชน์จากโครงสร้างของเอกสาร ที่กำหนดโดยสไตล์ที่ใช้ เพื่อนำเอกสารไปใช้ใหม่สำหรับเอาต์พุตอื่น เช่น HTML นี่คือความจริงแล้ววิธีการสร้างเอกสาร Aspose โดยนำ Aspose.Words ไปทดสอบ เครื่องมือที่สร้างโดยใช้ Aspose.Words จะนำเอกสาร Word ต้นฉบับและแบ่งออกเป็นหัวข้อในระดับหัวเรื่องบางระดับ ไฟล์ XML ถูกสร้างขึ้นโดยใช้ Aspose.Words ซึ่งใช้ในการสร้างแผนผังการนำทางที่คุณเห็นทางด้านซ้าย จากนั้น Aspose.Words จะแปลงแต่ละหัวข้อเป็น HTML
โซลูชันสำหรับการดึงข้อความที่จัดรูปแบบด้วยสไตล์เฉพาะในเอกสาร Word โดยทั่วไปแล้วจะประหยัดและตรงไปตรงมาโดยใช้ Aspose.Words
การแก้ไขปัญหา
เพื่อแสดงให้เห็นว่า Aspose.Words จัดการการดึงเนื้อหาตามสไตล์ได้ง่ายเพียงใด มาดูตัวอย่างกัน ในตัวอย่างนี้ เราจะดึงข้อความที่จัดรูปแบบด้วยลักษณะย่อหน้าเฉพาะและลักษณะอักขระจากเอกสาร Word ตัวอย่าง ในระดับสูงจะเกี่ยวข้องกับ:
- การเปิดเอกสาร Word โดยใช้คลาส Document
- รับคอลเลกชันของย่อหน้าทั้งหมดและการดำเนินการทั้งหมดในเอกสาร
- เลือกเฉพาะย่อหน้าที่ต้องการและดำเนินการ โดยเฉพาะอย่างยิ่ง เราจะดึงข้อความที่จัดรูปแบบด้วยลักษณะย่อหน้า ‘Heading 1’ และลักษณะอักขระ ‘Intense Emphasis’ จากเอกสาร Word ตัวอย่างนี้
ในเอกสารตัวอย่างนี้ ข้อความที่จัดรูปแบบด้วยลักษณะย่อหน้า ‘หัวเรื่อง 1’ คือ ‘แทรกแท็บ’ ‘ลักษณะด่วน’ และ ‘ธีม’ และข้อความที่จัดรูปแบบด้วยลักษณะอักขระ ‘เน้นหนักแน่น’ จะเป็นสีน้ำเงินหลายกรณี ข้อความตัวเอียงและตัวหนา เช่น ‘แกลเลอรี’ และ ‘รูปลักษณ์โดยรวม’
รหัส
การใช้งานการสืบค้นตามสไตล์นั้นค่อนข้างง่ายในโมเดลออบเจ็กต์เอกสาร Aspose.Words เนื่องจากใช้เครื่องมือที่มีอยู่แล้วเท่านั้น มีการนำเมธอดคลาสสองวิธีมาใช้กับโซลูชันนี้:
- ย่อหน้า_by_style_name - วิธีการนี้จะดึงข้อมูลอาร์เรย์ของย่อหน้าเหล่านั้นในเอกสารที่มีชื่อสไตล์เฉพาะ
- run_by_style_name - วิธีการนี้จะดึงข้อมูลอาร์เรย์ของการรันเหล่านั้นในเอกสารที่มีชื่อสไตล์เฉพาะ ทั้งสองวิธีมีความคล้ายคลึงกันมาก ความแตกต่างเพียงอย่างเดียวคือประเภทโหนดและการแสดงข้อมูลสไตล์ภายในย่อหน้าและโหนดที่รัน นี่คือการใช้งาน
paragraphs_by_style_name: ตัวอย่างด้านล่างค้นหาย่อหน้าทั้งหมดที่จัดรูปแบบด้วยสไตล์ที่ระบุ
การใช้งานนี้ยังใช้วิธี Document.get_child_nodes ของคลาส Document ซึ่งส่งคืนคอลเลกชันของโหนดทั้งหมดตามประเภทที่ระบุ ซึ่งในกรณีนี้ในทุกย่อหน้า
โปรดทราบว่าพารามิเตอร์ที่สองของวิธี Document.get_child_nodes ถูกตั้งค่าเป็น True วิธีนี้จะบังคับให้วิธี Document.get_child_nodes เลือกจากโหนดย่อยทั้งหมดแบบวนซ้ำ แทนที่จะเลือกเฉพาะโหนดย่อยที่อยู่ติดกัน
นอกจากนี้ ยังควรชี้ให้เห็นว่าคอลเลกชันย่อหน้าไม่ได้สร้างค่าใช้จ่ายทันที เนื่องจากย่อหน้าจะถูกโหลดลงในคอลเลกชันนี้เฉพาะเมื่อคุณเข้าถึงรายการในย่อหน้าเท่านั้น จากนั้น สิ่งที่คุณต้องทำคือไปที่คอลเล็กชันโดยใช้ตัวดำเนินการ foreach มาตรฐาน และเพิ่มย่อหน้าที่มีสไตล์ที่ระบุลงในอาร์เรย์ Paragraphs_with_style ชื่อรูปแบบ Paragraph สามารถพบได้ในคุณสมบัติ Style.name ของวัตถุ Paragraph.paragraph_format การใช้งาน run_by_style_name เกือบจะเหมือนกัน แม้ว่าเราจะใช้ NodeType.RUN เพื่อดึงโหนดที่รันอยู่ก็ตาม คุณสมบัติ Font.style ของวัตถุ Run ใช้เพื่อเข้าถึงข้อมูลสไตล์ในโหนด Run ตัวอย่างด้านล่างค้นหาการรันทั้งหมดที่จัดรูปแบบด้วยสไตล์ที่ระบุ
เมื่อนำคำค้นหาทั้งสองไปใช้ สิ่งที่คุณต้องทำคือส่งวัตถุเอกสารและระบุชื่อสไตล์ของเนื้อหาที่คุณต้องการดึงข้อมูล: ตัวอย่างด้านล่างเรียกใช้คำค้นหาและแสดงผลลัพธ์ คุณสามารถดาวน์โหลดไฟล์เทมเพลตของตัวอย่างนี้ได้จาก ที่นี่
ผลลัพธ์สุดท้าย
เมื่อทุกอย่างเสร็จสิ้น การรันตัวอย่างจะแสดงเอาต์พุตต่อไปนี้:
อย่างที่คุณเห็น นี่เป็นตัวอย่างง่ายๆ ที่แสดงหมายเลขและข้อความของย่อหน้าที่รวบรวมและเรียกใช้ในเอกสาร Word ตัวอย่าง
คัดลอกสไตล์ทั้งหมดจากเทมเพลต
มีหลายกรณีที่คุณต้องการคัดลอกสไตล์ทั้งหมดจากเอกสารหนึ่งไปยังอีกเอกสารหนึ่ง คุณสามารถใช้วิธี Document.copy_styles_from_template เพื่อคัดลอกสไตล์จากเทมเพลตที่ระบุไปยังเอกสารได้ เมื่อสไตล์ถูกคัดลอกจากเทมเพลตไปยังเอกสาร สไตล์ที่มีชื่อเหมือนกันในเอกสารจะถูกกำหนดใหม่เพื่อให้ตรงกับคำอธิบายสไตล์ในเทมเพลต สไตล์เฉพาะจากเทมเพลตจะถูกคัดลอกไปยังเอกสาร สไตล์ที่เป็นเอกลักษณ์ในเอกสารยังคงเหมือนเดิม ตัวอย่าง Below code แสดงวิธีการคัดลอกสไตล์จากเอกสารหนึ่งไปยังอีกเอกสารหนึ่ง
วิธีจัดการคุณสมบัติของธีม
เราได้เพิ่ม API พื้นฐานใน Aspose.Words เพื่อเข้าถึงคุณสมบัติของธีมเอกสาร ในตอนนี้ API นี้มีวัตถุสาธารณะดังต่อไปนี้:
นี่คือวิธีที่คุณสามารถรับคุณสมบัติธีม:
และนี่คือวิธีที่คุณสามารถตั้งค่าคุณสมบัติของธีม: