Hiển Thị Hình Dạng Riêng biệt Với Tài liệu
Khi xử lý tài liệu, một nhiệm vụ phổ biến là trích xuất tất cả các hình ảnh được tìm thấy trong tài liệu và xuất chúng ra vị trí bên ngoài. Nhiệm vụ này trở nên đơn giản với Aspose.Words API, đã cung cấp chức năng trích xuất và lưu dữ liệu hình ảnh. Tuy nhiên, đôi khi bạn có thể muốn trích xuất tương tự các loại nội dung đồ họa khác được thể hiện bằng một loại đối tượng vẽ khác, ví dụ: hộp văn bản chứa các đoạn văn, hình mũi tên và hình ảnh nhỏ. Không có cách đơn giản nào để hiển thị đối tượng này vì nó là sự kết hợp của các yếu tố nội dung riêng lẻ. Bạn cũng có thể gặp một trường hợp khi nội dung đã được nhóm lại với nhau thành đối tượng trông giống như một hình ảnh duy nhất.
Aspose.Words cung cấp chức năng trích xuất loại nội dung này giống như cách bạn có thể trích xuất một hình ảnh đơn giản từ hình dạng dưới dạng nội dung được hiển thị. Bài viết này mô tả cách sử dụng chức năng này để hiển thị các hình dạng độc lập với tài liệu.
Các Loại hình dạng trong Aspose.Words
Tất cả nội dung trong một lớp vẽ tài liệu được biểu diễn bằng nút Shape hoặc GroupShape Trong Mô-đun Đối tượng Tài liệu Aspose.Words (DOM). Nội dung như vậy có thể là hộp văn bản, hình ảnh, AutoShapes, OLE đối tượng, v. v. Một số trường cũng được nhập dưới dạng hình dạng, ví dụ: trường INCLUDEPICTURE.
Một hình ảnh đơn giản được biểu diễn bằng một nút Shape của ShapeType.Image. Nút hình dạng này không có nút con nhưng dữ liệu hình ảnh có trong nút hình dạng này có thể được truy cập bởi thuộc tính Shape.ImageData. Mặt khác, một hình dạng cũng có thể được tạo thành từ nhiều nút con. Ví dụ, một hình dạng hộp văn bản, được đại diện bởi thuộc tính ShapeType.TextBox, có thể được tạo thành từ nhiều nút, chẳng hạn như Paragraph và Table. Hầu hết các hình dạng có thể bao gồm các nút cấp khối Paragraph và Table. Đây là những nút giống như những nút xuất hiện trong phần thân chính. Hình dạng luôn luôn là một phần của một số đoạn, hoặc bao gồm trực tiếp nội tuyến hoặc neo vào Paragraph, nhưng “nổi” bất cứ nơi nào trong trang tài liệu.
Một tài liệu cũng có thể chứa các hình dạng được nhóm lại với nhau. Nhóm có thể được bật trong Microsoft Word bằng cách chọn nhiều đối tượng và nhấp Vào “Nhóm” trong menu chuột phải.
Trong Aspose.Words, các nhóm hình dạng này được biểu diễn bằng nút GroupShape. Chúng cũng có thể được gọi theo cách tương tự để hiển thị toàn bộ nhóm cho hình ảnh.
Định dạng DOCX có thể chứa các loại hình ảnh đặc biệt, chẳng hạn như sơ đồ hoặc biểu đồ. Các hình dạng này cũng được biểu diễn thông qua nút Shape trong Aspose.Words, cũng cung cấp một phương pháp tương tự để hiển thị chúng dưới dạng hình ảnh. Theo thiết kế, một hình dạng không thể chứa một hình dạng khác khi còn nhỏ, trừ khi hình dạng đó là hình ảnh (ShapeType.Image). Ví dụ: Microsoft Word không cho phép bạn chèn một hộp văn bản bên trong một hộp văn bản khác.
Các loại hình dạng được mô tả ở trên cung cấp một phương thức đặc biệt để hiển thị các hình dạng thông qua lớp ShapeRenderer. Một thể hiện của lớp ShapeRenderer được truy xuất cho Shape hoặc GroupShape thông qua phương thức GetShapeRenderer hoặc bằng cách chuyển Shape đến hàm tạo của lớp ShapeRenderer. Lớp này cung cấp quyền truy cập vào các thành viên, cho phép hiển thị hình dạng như sau:
- Tệp trên đĩa bằng phương thức Save quá tải
- Truyền phát bằng phương thức Save quá tải
- Đối tượng
Graphicsbằng cách sử dụng các phương thức RenderToSize và RenderToScale
Kết xuất Thành Tệp hoặc Luồng
Phương thức Save cung cấp quá tải hiển thị hình dạng trực tiếp đến tệp hoặc luồng. Cả hai quá tải đều chấp nhận một thể hiện của lớp ImageSaveOptions, cho phép xác định các tùy chọn để hiển thị hình dạng. Điều này hoạt động theo cách tương tự như phương thức Document.Save. Mặc dù tham số này là bắt buộc, bạn có thể vượt qua giá trị null, chỉ định rằng không có tùy chọn tùy chỉnh.
Hình dạng có thể được xuất ở bất kỳ định dạng hình ảnh nào được chỉ định trong liệt kê SaveFormat. Ví dụ: hình ảnh có thể được hiển thị dưới dạng hình ảnh raster, chẳng hạn như JPEG bằng cách chỉ định liệt kê SaveFormat.Jpeg hoặc dưới dạng hình ảnh vectơ, chẳng hạn như EMF bằng cách chỉ định SaveFormat.Emf.
Ví dụ mã dưới đây minh họa kết xuất hình dạng thành hình ảnh EMF riêng biệt với tài liệu và lưu vào đĩa:
Ví dụ mã dưới đây minh họa hiển thị hình dạng thành hình ảnh JPEG riêng biệt với tài liệu và lưu vào luồng:
Lớp ImageSaveOptions cho phép bạn chỉ định nhiều tùy chọn kiểm soát cách hiển thị hình ảnh. Chức năng được mô tả ở trên có thể được áp dụng theo cách tương tự cho các nút GroupShape và Shape.
Kết xuất Đối tượng Đồ họa .NET
Kết xuất trực tiếp đến đối tượng Graphics cho phép bạn xác định cài đặt của riêng mình và trạng thái cho đối tượng Graphics. Một kịch bản phổ biến liên quan đến việc hiển thị một hình dạng trực tiếp vào một đối tượng Graphics được lấy từ một hình thức Windows hoặc Một Bitmap. Khi nút Shape được hiển thị, cài đặt sẽ ảnh hưởng đến giao diện hình dạng. Ví dụ: bạn có thể xoay hoặc chia tỷ lệ hình dạng bằng cách sử dụng các phương thức RotateTransform hoặc ScaleTransform cho đối tượng Graphics.
Ví dụ dưới đây cho thấy cách hiển thị hình dạng thành a .NET Graphics đối tượng riêng biệt với tài liệu và áp dụng xoay cho hình ảnh được hiển thị:
Tương tự, với phương thức RenderToSize, phương thức RenderToSize được kế thừa từ NodeRendererBase rất hữu ích để tạo hình thu nhỏ của nội dung tài liệu. Kích thước hình dạng được chỉ định thông qua hàm tạo. Phương thức RenderToSize chấp nhận đối tượng Graphics, tọa độ X Và Y của vị trí hình ảnh và kích thước của hình ảnh (chiều rộng và chiều cao) sẽ được vẽ lên đối tượng Graphics.
Shape có thể được kết xuất thành một thang đo nhất định bằng phương thức ShapeRenderer.RenderToScale được kế thừa từ lớp NodeRendererBase. Điều này tương tự như phương thức Document.RenderToScale chấp nhận các tham số chính giống nhau. Sự khác biệt giữa hai phương thức này là với phương thức ShapeRenderer.RenderToScale, thay vì kích thước theo nghĩa đen, bạn chọn một giá trị float chia tỷ lệ hình dạng trong quá trình kết xuất của nó. Nếu giá trị float bằng 1.0 làm cho hình dạng được hiển thị tại 100% kích thước ban đầu của nó. Giá trị float 0.5 sẽ giảm một nửa kích thước hình ảnh.
Hiển thị Hình Ảnh Hình Dạng
Lớp Shape đại diện cho các đối tượng trong lớp vẽ, chẳng hạn như AutoShape, hộp văn bản, dạng tự do, OLE đối tượng, Điều khiển ActiveX hoặc hình ảnh. Sử dụng lớp Shape, bạn có thể tạo hoặc sửa đổi hình dạng trong tài liệu Microsoft Word. Một thuộc tính quan trọng của một hình dạng là ShapeType của nó. Hình dạng của các loại khác nhau có thể có các khả năng khác nhau trong Tài liệu Word. Ví dụ: chỉ hình ảnh và OLE hình dạng mới có thể có hình ảnh bên trong chúng trong khi hầu hết các hình dạng chỉ có thể có văn bản.
Ví dụ sau đây cho thấy cách hiển thị hình Ảnh Hình dạng thành hình ảnh JPEG riêng biệt với tài liệu và lưu nó vào đĩa:
Lấy Một Kích Thước Hình Dạng
Lớp ShapeRenderer cũng cung cấp chức năng để lấy kích thước của hình dạng theo pixel thông qua phương thức GetSizeInPixels. Phương pháp này chấp nhận hai tham số kiểu float (Đơn) – tỷ lệ và DPI, được sử dụng trong tính toán kích thước hình dạng khi hình dạng được hiển thị. Phương thức trả về đối tượng Size, chứa chiều rộng và chiều cao của kích thước được tính toán. Điều này rất hữu ích khi cần biết trước kích thước của hình dạng được hiển thị, ví dụ như khi tạo Bitmap mới từ đầu ra được hiển thị.
Ví dụ dưới đây cho thấy cách tạo Một Đối tượng Bitmap và Đồ họa mới với chiều rộng và chiều cao của hình dạng sẽ được hiển thị:
Khi sử dụng các phương thức RenderToSize hoặc RenderToScale, kích thước hình ảnh được hiển thị cũng được trả về trong đối tượng SizeF. Điều này có thể được gán cho một biến và được sử dụng nếu cần thiết.
Thuộc tính SizeInPoints trả về kích thước Hình dạng được đo bằng điểm (xem ShapeRenderer. Kết quả là một đối tượng SizeF chứa chiều rộng và chiều cao.