รูปแบบหน้าภาพ
เค้าโครงหน้าภาพ
หน้านี้บันทึกเอกสารคลาสการกำหนดค่า MultiPageLayout และการนับจำนวนที่เกี่ยวข้องกับการเรนเดอร์ภาพ, และอธิบายว่าทำไมพวกมันจึงไม่มีเส้นทางการบันทึกที่ทำงานได้ในฉบับนี้.
Aspose.Words FOSS สำหรับ .NET มีชุดคลาสโมเดลขนาดเล็กสำหรับอธิบายว่าหน้าต่างเอกสารหลายหน้า จะถูกจัดเรียงอย่างไรเมื่อเรนเดอร์เป็นผลลัพธ์แบบภาพเดียว — MultiPageLayout และการนับจำนวนที่สนับสนุนของมัน รุ่นนี้ไม่ได้รวมเอาเอนจินการจัดหน้าและการเรนเดอร์เอง (ดู ฟีเจอร์และความสามารถ และ ภาพรวมของผลิตภัณฑ์), ดังนั้นประเภทเหล่านี้จึงมีอยู่ในพื้นผิวสาธารณะของ API เป็น primitive การกำหนดค่าโดยไม่มีเส้นทางการบันทึกที่ใช้พวกมันในรุ่นนี้.
MultiPageLayout
MultiPageLayout เป็นคลาสที่ถูกปิด (sealed) ที่มีเมธอดแฟกทอรีแบบ static แต่ละเมธอดสร้างการจัดเรียงหลายหน้าแบบต่างๆ: Vertical(verticalGap) จัดเรียงหน้าตั้งจากบนลงล่างพร้อมช่องว่างที่กำหนดระหว่างหน้า; Horizontal(horizontalGap) วางหน้าข้างกันจากซ้ายไปขวา; Grid(columns, horizontalGap, verticalGap) จัดหน้าจากซ้ายไปขวาและจากบนลงล่างเป็นตารางตามจำนวนคอลัมน์ที่ระบุ; TiffFrames() เก็บแต่ละหน้าเป็นเฟรมแยกต่างหากแทนการรวมเป็นภาพเดียว; และ SinglePage() เรนเดอร์เพียงหน้าหนึ่งหน้าเท่านั้น. เมื่อสร้างแล้ว อินสแตนซ์ของ MultiPageLayout จะเปิดเผย BackColor และ BorderColor (ทั้งสองเป็น Color) และ BorderWidth (float) สำหรับการจัดสไตล์ของผลลัพธ์ที่รวมกัน.
การนับจำนวนการเรนเดอร์ที่เกี่ยวข้อง
การนับจำนวนเพิ่มเติมสามรายการอธิบายโดเมนเดียวกันของ “หน้าตามเอกสารเป็นภาพ”: ImageColorMode (None, Grayscale, BlackAndWhite) ควบคุมโหมดสีของภาพหน้าที่สร้างขึ้น; ImagePixelFormat แสดงรายการรูปแบบพิกเซลที่ใช้ได้สำหรับภาพหน้าที่สร้าง (เช่น Format24BppRgb และ Format32BppArgb); และ ImageBinarizationMethod (Threshold, FloydSteinbergDithering) ระบวิธีที่ภาพถูกแปลงเป็นขาว-ดำ. เช่นเดียวกับ MultiPageLayout, สิ่งเหล่านี้ถูกกำหนดในพื้นผิวของ API แต่ยังไม่ได้เชื่อมต่อกับคลาสตัวเลือกการบันทึกในฉบับนี้ — การสร้าง FOSS นี้ไม่ได้รวมการส่งออกเป็นภาพ, PDF, หรือ XPS.
เคล็ดลับและแนวปฏิบัติที่ดีที่สุด
- ถือว่า
MultiPageLayoutและ enumeration ที่เกี่ยวข้องเป็นการอ้างอิงเท่านั้นในฉบับนี้ — ไม่มีเส้นทางSave()ในพื้นผิว API สาธารณะที่ใช้MultiPageLayoutเพื่อสร้างภาพจริง. - หากเวิร์กโฟลว์ของคุณต้องการเรนเดอร์เอกสาร Word ไปเป็น TIFF, PNG, JPEG หรือรูปแบบภาพอื่น ๆ ให้ใช้เวอร์ชันเชิงพาณิชย์ Aspose.Words สำหรับ .NET, ซึ่งรวมถึงเอนจินการเรนเดอร์เต็มรูปแบบที่ประเภทเหล่านี้ออกแบบมาสำหรับ.
- อย่าสับสนพื้นที่การจัดหน้าเพื่อรูปภาพนี้กับการฝังรูปภาพในเอกสาร (
Shape/ImageDataAPI) — นั่นเป็นฟีเจอร์เนื้อหาเอกสารปกติที่แยกออกจากการเรนเดอร์หน้า.
ปัญหาทั่วไป
| ปัญหา | สาเหตุ | วิธีแก้ |
|---|---|---|
ไม่มีเมธอดใดยอมรับอินสแตนซ์ของ MultiPageLayout | รุ่นนี้ไม่ได้รวมเอ็นจินการเรนเดอร์ image/PDF/XPS | ใช้ Aspose.Words เชิงพาณิชย์สำหรับ .NET เพื่อการเรนเดอร์หน้าและการส่งออกภาพ |
การแปลง Document.Save() ไปเป็นส่วนขยายภาพล้มเหลว | ฉบับนี้ไม่รวมเอา engine การเรนเดอร์ image/PDF/XPS ที่รูปแบบการบันทึกแบบภาพต้องการ | บันทึกเป็น DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown หรือ plain text แทน |
FAQ
ฉันสามารถใช้ MultiPageLayout เพื่อส่งออกเอกสารของฉันเป็น TIFF หลายหน้าได้หรือไม่?
ไม่มีในฉบับนี้ MultiPageLayout และ enumeration ที่สนับสนุน (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) มีอยู่ในพื้นผิว API แต่ pipeline การบันทึกการเรนเดอร์ภาพที่ใช้พวกมันไม่ได้รวมอยู่ใน build FOSS นี้.
ทำไมคลาสนี้ถึงมีอยู่ถ้ามันไม่มีฟังก์ชันการทำงานที่นี่?
Aspose.Words FOSS สำหรับ .NET คือฐานโค้ด Aspose.Words ของแท้ที่ถูกลดลงเป็นแกนฟรี ไม่ใช่การเขียนใหม่ — คลาสระดับโมเดลบางส่วนที่ผูกกับเอนจิ้นการเรนเดอร์ที่ถูกลบยังคงถูกคอมไพล์ไว้ในไลบรารีแม้ว่าไม่มีเส้นทางการบันทึกที่รองรับใดๆ ใช้งานอยู่ในขณะนี้.
การฝังรูปภาพในเอกสารก็ถูกยกเว้นด้วยหรือ?
ไม่ — การแทรกและจัดรูปแบบรูปภาพภายในเนื้อหาเอกสาร (ผ่าน Shape และ ImageData) เป็นคุณลักษณะการแก้ไขเอกสารที่ปกติและได้รับการสนับสนุน เฉพาะการเรนเดอร์หน้าทั้งหมดเป็นรูปภาพรูปแบบใดรูปแบบหนึ่งเท่านั้นที่ถูกยกเว้น.
API Reference สรุป
| คลาส / Enum | คำอธิบาย |
|---|---|
MultiPageLayout | กำหนดวิธีการรวมหลายหน้าเป็นผลลัพธ์แบบภาพเดียว (Vertical, Horizontal, Grid, TiffFrames, SinglePage) |
ImageColorMode | โหมดสีสำหรับภาพหน้าที่สร้างขึ้น (None, Grayscale, BlackAndWhite) |
ImagePixelFormat | ตัวเลือกรูปแบบพิกเซลสำหรับภาพหน้าที่สร้างขึ้น |
ImageBinarizationMethod | วิธีการแปลงเป็นขาว-ดำ (Threshold, FloydSteinbergDithering) |