การทำงานกับ SDT การควบคุมเนื้อหา
ใน Microsoft Word คุณสามารถสร้างแบบฟอร์มได้โดยเริ่มต้นด้วยเทมเพลตและเพิ่มการควบคุมเนื้อหา รวมถึงช่องทำเครื่องหมาย กล่องข้อความ ตัวเลือกวันที่ และรายการแบบเลื่อนลง ใน Aspose.Words แท็กเอกสารที่มีโครงสร้างหรือการควบคุมเนื้อหาจากเอกสารใดๆ ที่โหลดลงใน Aspose.Words จะถูกนำเข้าเป็นโหนด StructuredDocumentTag แท็กเอกสารที่มีโครงสร้าง (SDT หรือการควบคุมเนื้อหา) ช่วยให้สามารถฝังความหมายที่ลูกค้ากำหนดตลอดจนลักษณะการทำงานและรูปลักษณ์ลงในเอกสารได้
StructuredDocumentTag สามารถเกิดขึ้นในเอกสารในตำแหน่งต่อไปนี้:
- ระดับบล็อก - ระหว่างย่อหน้าและตารางในฐานะลูกของ Body, HeaderFooter, ความคิดเห็น, เชิงอรรถหรือโหนดรูปร่าง
- ระดับแถว – ท่ามกลางแถวในตาราง เป็นลูกของโหนดตาราง
- ระดับเซลล์ – ท่ามกลางเซลล์ในแถวของตาราง เป็นลูกของโหนดแถว
- ระดับอินไลน์ – ท่ามกลางเนื้อหาอินไลน์ภายใน เป็นรายการย่อยของย่อหน้า
- ซ้อนอยู่ภายใน StructuredDocumentTag อื่น
การแทรกการควบคุมเนื้อหาลงในเอกสาร
ใน Aspose.Words เวอร์ชันนี้ คุณจะสร้าง SDT หรือการควบคุมเนื้อหาประเภทต่อไปนี้ได้
- Checkbox
- DropDownList
- ComboBox
- Date
- BuildingBlockGallery
- Group
Picture- RichText
- PlainText
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างการควบคุมเนื้อหาประเภทช่องทำเครื่องหมาย:
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างการควบคุมเนื้อหาของกล่องข้อความชนิด rich text:
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างการควบคุมเนื้อหาของกล่องคำสั่งผสมชนิด:
วิธีอัปเดตการควบคุมเนื้อหา
ส่วนนี้อธิบายวิธีอัปเดตค่า SDT หรือการควบคุมเนื้อหาโดยทางโปรแกรม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตั้งค่าสถานะปัจจุบันของช่องทำเครื่องหมาย:
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการปรับเปลี่ยนการควบคุมเนื้อหาของประเภทกล่องข้อความธรรมดา รายการแบบหล่นลง และรูปภาพ:
การเชื่อมโยงการควบคุมเนื้อหาเข้ากับส่วน XML ที่กำหนดเอง
คุณสามารถผูกตัวควบคุมเนื้อหากับข้อมูล XML (ส่วน XML แบบกำหนดเอง) ในเอกสาร Word ได้
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการผูกการควบคุมเนื้อหากับส่วน XML แบบกำหนดเอง:
XMLMapping ของช่วงแท็กเอกสารที่มีโครงสร้าง
คุณสามารถรับการแมปช่วงแท็กเอกสารที่มีโครงสร้างนี้กับข้อมูล XML ในส่วน XML ที่กำหนดเองของเอกสารปัจจุบันได้โดยใช้ คุณสมบัติ StructuredDocumentTagRangeStart.XmlMapping อย่างไรก็ตาม สามารถใช้วิธี SetMapping เพื่อแมปช่วงแท็กเอกสารที่มีโครงสร้างกับข้อมูล XML
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตั้งค่าการแมป XML:
ล้างเนื้อหาของการควบคุมเนื้อหา
คุณสามารถล้างเนื้อหาของตัวควบคุมเนื้อหาด้วยการแสดงพื้นที่ที่สำรองไว้ เมธอด StructuredDocumentTag.Clear จะล้างเนื้อหาของแท็กเอกสารที่มีโครงสร้างนี้ และแสดงตัวยึดตำแหน่งหากมีการกำหนดไว้ อย่างไรก็ตาม ไม่สามารถล้างเนื้อหาของตัวควบคุมเนื้อหาได้หากมีการแก้ไข ถ้าตัวควบคุมเนื้อหาไม่มีพื้นที่ที่สำรองไว้ ระบบจะแทรกช่องว่างห้าช่องเหมือนใน Microsoft Word (ยกเว้นส่วนที่ทำซ้ำ รายการส่วนที่ซ้ำ กลุ่ม กล่องกาเครื่องหมาย ข้อมูลอ้างอิง) ถ้าตัวควบคุมเนื้อหาถูกแมปกับ XML แบบกำหนดเอง โหนด XML ที่อ้างอิงจะถูกล้าง
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการล้างเนื้อหาของการควบคุมเนื้อหา:
เปลี่ยนพื้นหลังการควบคุมเนื้อหาและสีเส้นขอบ
คุณสมบัติ StructuredDocumentTag.Color ช่วยให้คุณสามารถรับหรือตั้งค่าสีของการควบคุมเนื้อหาได้ สีส่งผลต่อการควบคุมเนื้อหาในสองสถานการณ์:
- MS Word เน้นพื้นหลังของตัวควบคุมเนื้อหาเมื่อเลื่อนเมาส์ไปเหนือตัวควบคุมเนื้อหา ซึ่งช่วยในการระบุการควบคุมเนื้อหา สีไฮไลต์จะ “อ่อนกว่า” เล็กน้อยกว่า Color ตัวอย่างเช่น MS Word เน้นพื้นหลังด้วยสีชมพู เมื่อ Color เป็นสีแดง
- เมื่อคุณโต้ตอบ (แก้ไข การเลือก ฯลฯ) กับตัวควบคุมเนื้อหา เส้นขอบของตัวควบคุมเนื้อหาจะมีสีด้วย Color
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการเปลี่ยนสีของการควบคุมเนื้อหา:
วิธีการตั้งค่าสไตล์เพื่อจัดรูปแบบข้อความที่พิมพ์ลงในตัวควบคุมเนื้อหา
ถ้าคุณต้องการตั้งค่าสไตล์ของการควบคุมเนื้อหา คุณสามารถใช้คุณสมบัติ StructuredDocumentTag.Style หรือ StructuredDocumentTag.StyleName ได้ เมื่อคุณพิมพ์ข้อความลงในตัวควบคุมเนื้อหาในเอกสารผลลัพธ์ ข้อความที่พิมพ์จะมีลักษณะเป็น “เครื่องหมายคำพูด”
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการตั้งค่ารูปแบบของการควบคุมเนื้อหา:
การทำงานกับการควบคุมเนื้อหาส่วนการทำซ้ำ
การควบคุมเนื้อหาส่วนที่ทำซ้ำช่วยให้สามารถทำซ้ำเนื้อหาที่มีอยู่ภายในได้ เมื่อใช้ Aspose.Words คุณสามารถสร้างโหนดแท็กเอกสารที่มีโครงสร้างของส่วนการทำซ้ำและประเภทรายการส่วนที่ทำซ้ำได้ และเพื่อจุดประสงค์นี้ ประเภทการแจงนับ SdtType จึงจัดเตรียมคุณสมบัติ RepeatingSectionItem
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการผูกตัวควบคุมเนื้อหาส่วนที่ทำซ้ำกับตาราง