Bố cục Trang Hình ảnh
Bố cục Trang Hình ảnh
Trang này tài liệu lớp cấu hình MultiPageLayout và các enumeration liên quan đến việc render hình ảnh, và giải thích lý do chúng không có đường lưu chức năng trong phiên bản này.
Aspose.Words FOSS cho .NET bao gồm một bộ nhỏ các lớp mô hình để mô tả cách nhiều trang tài liệu sẽ được sắp xếp khi được render thành một đầu ra dựa trên hình ảnh duy nhất — MultiPageLayout và các enumerations hỗ trợ của nó. Phiên bản này không bao gồm chính engine bố cục trang và render (see Các tính năng và chức năng và tổng quan sản phẩm), vì vậy các kiểu này tồn tại trong bề mặt công khai của API như các primitive cấu hình mà không có đường lưu nào tiêu thụ chúng trong bản dựng này.
MultiPageLayout
MultiPageLayout là một lớp sealed mà các phương thức factory tĩnh của nó mỗi cái tạo một cách sắp xếp đa trang khác nhau: Vertical(verticalGap) xếp chồng các trang từ trên xuống dưới với khoảng cách đã cho giữa chúng; Horizontal(horizontalGap) đặt các trang cạnh nhau, từ trái sang phải; Grid(columns, horizontalGap, verticalGap) sắp xếp các trang từ trái sang phải, từ trên xuống dưới trong một lưới với số cột được chỉ định; TiffFrames() giữ mỗi trang như một khung riêng biệt thay vì kết hợp chúng thành một hình ảnh; và SinglePage() chỉ render một trang duy nhất. Sau khi được tạo, một thể hiện MultiPageLayout cung cấp BackColor và BorderColor (cả hai là Color) và BorderWidth (float) để định kiểu đầu ra đã kết hợp.
Các Enumeration Rendering liên quan
Ba enumeration bổ sung mô tả cùng miền “các trang tài liệu dưới dạng hình ảnh”: ImageColorMode (None, Grayscale, BlackAndWhite) điều khiển chế độ màu của các hình ảnh trang được tạo; ImagePixelFormat liệt kê các định dạng pixel có sẵn cho các hình ảnh trang được tạo (như Format24BppRgb và Format32BppArgb); và ImageBinarizationMethod (Threshold, FloydSteinbergDithering) chỉ định cách một hình ảnh được chuyển đổi thành đen-trắng. Giống như MultiPageLayout, chúng được định nghĩa trong bề mặt API nhưng hiện chưa được kết nối với lớp tùy chọn lưu trong phiên bản này — bản dựng FOSS này không bao gồm xuất ảnh, PDF hoặc XPS.
Mẹo và Thực hành Tốt nhất
- Xem
MultiPageLayoutvà các liệt kê liên quan của nó chỉ là tham khảo trong ấn bản này — không có đường dẫnSave()nào trong bề mặt API công cộng tiêu thụ một thể hiệnMultiPageLayoutđể thực sự tạo ra hình ảnh. - Nếu quy trình làm việc của bạn cần render tài liệu Word sang TIFF, PNG, JPEG, hoặc các định dạng ảnh khác, hãy sử dụng phiên bản thương mại Aspose.Words cho .NET, bao gồm toàn bộ engine render mà các kiểu này được thiết kế cho.
- Đừng nhầm lẫn khu vực bố cục trang cho hình ảnh này với việc nhúng ảnh vào tài liệu (the
Shape/ImageDataAPI) — đây là một tính năng nội dung tài liệu bình thường, riêng biệt, không phải việc render trang.
Các Vấn đề Thông thường
| Vấn đề | Nguyên nhân | Khắc phục |
|---|---|---|
Không có phương thức nào chấp nhận một thể hiện MultiPageLayout | Bản phát hành này không bao gồm engine render image/PDF/XPS | Sử dụng Aspose.Words thương mại cho .NET để render trang và xuất ảnh |
Document.Save() sang phần mở rộng ảnh không thành công | Phiên bản này loại trừ engine render image/PDF/XPS mà các định dạng lưu dựa trên hình ảnh yêu cầu | Lưu dưới dạng DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, hoặc văn bản thuần thay thế |
FAQ
Tôi có thể sử dụng MultiPageLayout để xuất tài liệu của mình dưới dạng TIFF đa trang không?
Không có trong ấn bản này. MultiPageLayout và các liệt kê hỗ trợ của nó (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) có trong bề mặt API, nhưng quy trình lưu render hình ảnh tiêu thụ chúng không nằm trong bản dựng FOSS này.
Tại sao lớp này tồn tại nếu nó không hoạt động ở đây?
Aspose.Words FOSS cho .NET là mã nguồn Aspose.Words thực sự được giảm xuống thành một lõi miễn phí, không phải một bản viết lại — một số lớp tầng mô hình liên kết với engine render đã bị loại bỏ vẫn được biên dịch vào thư viện mặc dù không có đường lưu nào được hỗ trợ hiện đang sử dụng chúng.
Việc nhúng hình ảnh vào trong tài liệu cũng bị loại trừ không?
Không — việc chèn và định dạng hình ảnh trong nội dung tài liệu (thông qua Shape và ImageData) là một tính năng chỉnh sửa tài liệu bình thường và được hỗ trợ. Chỉ việc render toàn bộ trang sang định dạng hình ảnh mới bị loại trừ.
API Reference Tóm tắt
| Lớp / Enum | Mô tả |
|---|---|
MultiPageLayout | Cấu hình cách nhiều trang được hợp nhất thành một đầu ra dựa trên hình ảnh (Vertical, Horizontal, Grid, TiffFrames, SinglePage) |
ImageColorMode | Chế độ màu cho các hình ảnh trang được tạo (None, Grayscale, BlackAndWhite) |
ImagePixelFormat | Các tùy chọn định dạng pixel cho hình ảnh trang được tạo |
ImageBinarizationMethod | Phương pháp chuyển đổi đen-trắng (Threshold, FloydSteinbergDithering) |