Cách Thêm Hình Vẽ Vào Tài Liệu Word trong .NET

Bước 1: Lấy Thư Viện

Sao chép kho lưu trữ và biên dịch Aspose.Words.sln trong cấu hình Release, sau đó thêm tham chiếu dự án tới Aspose.Words.csproj từ dự án .NET của bạn, như mô tả trong hướng dẫn cài đặt. Thêm using Aspose.Words; and using Aspose.Words.Drawing; ở đầu bất kỳ tệp nào làm việc với shapes.

Bước 2: Thêm một AutoShape

Tạo một hình trực tiếp bằng new Shape(doc, shapeType), trong đó shapeType là một giá trị ShapeType như Rectangle, Ellipse, Star, hoặc TextBox, sau đó chèn nó vào cây bằng DocumentBuilder.InsertNode(node). Shape là lớp cụ thể, sealed mà bạn tạo và cấu hình; nó kế thừa từ lớp trừu tượng ShapeBase, lớp này định nghĩa vị trí (Left, Top, Width, Height, Rotation) và các đối tượng phụ định dạng (Fill, Stroke, ShadowFormat, Glow, Reflection) được chia sẻ với GroupShape.

Bước 3: Thêm hình ảnh

DocumentBuilder.InsertImage là cách trực tiếp để thêm hình ảnh: các overload chấp nhận một Image, một đường dẫn tệp, một Stream, hoặc một mảng byte thô, với các overload bổ sung nhận các width/height rõ ràng hoặc các đối số vị trí đầy đủ (horzPos, left, vertPos, top, width, height, wrapType). Thuộc tính ImageData của Shape kết quả chứa dữ liệu hình ảnh — gọi ImageData.SetImage(...) để thay đổi hình ảnh, và sử dụng CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast, và GrayScale để điều chỉnh cơ bản.

Bước 4: Định vị hình dạng và bọc văn bản

Một hình dạng nội tuyến (kết quả mặc định của InsertImage) di chuyển cùng với văn bản xung quanh và bỏ qua các thuộc tính vị trí cho đến khi nó được đặt ở chế độ nổi — kiểm tra IsInline để xác nhận hình dạng đang ở chế độ nào. Để đặt một hình dạng nổi, đặt WrapType thành giá trị không phải nội tuyến và đặt RelativeHorizontalPosition / RelativeVerticalPosition (mỗi cái tương đối với Page, Margin, Column, hoặc một neo tương tự) cùng với các offset Left/Top. WrapSide điều khiển việc bọc theo phía cụ thể, và HorizontalAlignment / VerticalAlignment xử lý căn chỉnh tương đối đơn giản thay vì các offset rõ ràng.

Bước 5: Đổ màu và tạo kiểu cho hình dạng

Shape.Fill (một đối tượng Fill) tô bên trong của hình dạng: Fill.Solid(color) cho màu đồng nhất, Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) cho gradient, Fill.Patterned(patternType) cho mẫu, và Fill.SetImage(...) cho việc đổ hình ảnh — FillType báo cáo cái nào hiện đang hoạt động. Đường viền được lấy từ thuộc tính Stroke. Đối với các hiệu ứng, ShadowFormat, Glow (GlowFormat), Reflection (ReflectionFormat), và SoftEdge (SoftEdgeFormat) mỗi cái đều tiết lộ các cài đặt riêng và một phương thức Remove() để xóa hiệu ứng về không.

Bước 6: Nhóm nhiều hình dạng

Kết hợp một số hình dạng thành một đơn vị duy nhất bằng DocumentBuilder.InsertGroupShape(shapes), hàm này trả về một GroupShape. GroupShape tự nó là một ShapeBase, vì vậy nó mang các Fill, ShadowFormat, Glow, và Reflection riêng của mình áp dụng cho toàn bộ nhóm; di chuyển hoặc thay đổi kích thước GroupShape thay vì các thành phần con riêng lẻ để phép biến đổi tọa độ của nhóm luôn nhất quán. Đối với một hình dạng chứa văn bản, Shape.TextBox (một đối tượng TextBox) kiểm soát khoảng đệm (InternalMarginLeft/Right/Top/Bottom), tự động thay đổi kích thước (FitShapeToText), hướng văn bản (LayoutFlow), và căn chỉnh dọc (VerticalAnchor).

Bước 7: Thêm Đánh Dấu Nước

Document.Watermark quản lý một watermark duy nhất trên toàn tài liệu, độc lập với bất kỳ hình dạng nào bạn đã chèn thủ công. Gọi Watermark.SetText(text) hoặc SetText(text, options) để tạo watermark văn bản, hoặc SetImage(...) để tạo watermark hình ảnh; Watermark.Remove() sẽ xóa nó, và Watermark.Type báo cáo WatermarkType hiện tại (Text, Image, hoặc None). TextWatermarkOptions thiết lập FontFamily, FontSize, Color, và Layout (WatermarkLayout.Horizontal hoặc Diagonal); ImageWatermarkOptions thiết lập Scale và IsWashout.