如何在 .NET 中向 Word 文档添加绘图形状

步骤 1：获取库

克隆仓库并构建 Aspose.Words.sln 在 Release 配置下，然后将项目引用添加到 Aspose.Words.csproj 从您自己的 .NET 项目中，如文档所述 安装指南。添加 using Aspose.Words; and using Aspose.Words.Drawing; 在任何使用形状的文件顶部.

步骤 2：添加一个 AutoShape

使用 new Shape(doc, shapeType) 直接构造形状，其中 shapeType 是一个 ShapeType 值，例如 Rectangle、Ellipse、Star 或 TextBox，然后使用 DocumentBuilder.InsertNode(node) 将其插入到树中。Shape 是您构造并配置的具体、密封类；它继承自抽象的 ShapeBase，该类定义了位置（Left、Top、Width、Height、Rotation）和格式化子对象（Fill、Stroke、ShadowFormat、Glow、Reflection），这些与 GroupShape 共享。

步骤 3：添加图片

DocumentBuilder.InsertImage 是处理图片的直接途径：重载接受 Image、文件路径、Stream 或原始字节数组，并且还有接受显式 width/height 或完整定位参数（horzPos、left、vertPos、top、width、height、wrapType）的进一步重载。生成的 Shape 的 ImageData 属性保存图片数据——调用 ImageData.SetImage(...) 可替换图像，并使用 CropTop/CropBottom/CropLeft/CropRight、Brightness、Contrast 和 GrayScale 进行基本调整。

步骤 4：定位形状并环绕文字

内联形状（InsertImage 的默认结果）随周围文字流动，并在未浮动前忽略定位属性——检查 IsInline 以确认形状所处的模式。要使形状浮动，将 WrapType 设置为非内联值，并将 RelativeHorizontalPosition / RelativeVerticalPosition（均相对于 Page、Margin、Column 或类似锚点）与 Left/Top 偏移一起设置。WrapSide 控制侧向换行，HorizontalAlignment / VerticalAlignment 处理简单的相对对齐，而不是显式偏移。

步骤 5：填充和样式化形状

Shape.Fill（一个 Fill 对象）为形状内部着色：Fill.Solid(color) 用于纯色，Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) 用于渐变，Fill.Patterned(patternType) 用于图案，Fill.SetImage(...) 用于图片填充——FillType 报告当前激活的是哪一种。轮廓来源于 Stroke 属性。对于效果，ShadowFormat、Glow（GlowFormat）、Reflection（ReflectionFormat）和 SoftEdge（SoftEdgeFormat）各自公开其设置，并提供一个 Remove() 方法以将效果清除为无。

步骤 6：组合多个形状

使用 DocumentBuilder.InsertGroupShape(shapes) 将多个形状合并为一个单元，该方法返回一个 GroupShape。GroupShape 本身是一个 ShapeBase，因此它拥有自己的 Fill、ShadowFormat、Glow 和 Reflection，这些属性适用于整个组；移动或调整 GroupShape 的大小而不是其各个子项，以保持组的坐标变换一致。对于携带文本的形状，Shape.TextBox（一个 TextBox 对象）控制内边距（InternalMarginLeft/Right/Top/Bottom）、自动大小（FitShapeToText）、文字方向（LayoutFlow）以及垂直对齐（VerticalAnchor）。

第7步：添加水印

Document.Watermark 管理一个全局的文档水印，独立于您手动插入的任何形状。调用 Watermark.SetText(text) 或 SetText(text, options) 可创建文本水印，或调用 SetImage(...) 可创建图片水印；Watermark.Remove() 用于清除它，Watermark.Type 用于报告当前的 WatermarkType（Text、Image 或 None）。TextWatermarkOptions 设置 FontFamily、FontSize、Color 和 Layout（WatermarkLayout.Horizontal 或 Diagonal）；ImageWatermarkOptions 设置 Scale 和 IsWashout。