使用水印
使用水印
本指南展示了如何在 Aspose.Words FOSS 用于 .NET 使用 Watermark 类，通过 Document.Watermark. 水印可以是文字或图片，并且在同一文档中一次只能有一个水印——设置新的水印会替换之前的水印。
添加文本水印
Watermark.SetText(text) 添加一个带默认格式的文本水印。SetText(text, options) 的重载接受一个 TextWatermarkOptions 实例来控制其外观：FontFamily、Color 和 FontSize 控制文本格式，IsSemitrasparent 切换水印常见的半透明效果，Layout（一个 WatermarkLayout 值——Horizontal 或 Diagonal）控制其相对于页面的方向。
添加图像水印
Watermark.SetImage(image) 从已加载的 Image 中添加图像水印。接受 ImageWatermarkOptions 实例的重载——SetImage(image, options)、SetImage(imagePath, options)（从文件路径加载）和 SetImage(imageStream, options)（从 Stream 加载）——允许你控制 Scale（图像的缩放因子，以分数表示）和 IsWashout（使水印图像不会压过页面内容的褪色效果）。
检查并移除水印
Watermark.Type 报告当前水印的类型为 WatermarkType 值——Text、Image 或 None（如果未设置水印）。调用 Watermark.Remove() 可从文档中移除当前水印。
提示与最佳实践
- 在假设存在水印之前，请检查
Watermark.Type——在从未设置过水印的文档上，它返回WatermarkType.None。 - 通过
SetText()或SetImage()设置新水印会替换任何已有的水印；一次只能有一个激活的水印，无法同时存在多个。 - 使用
WatermarkLayout.Diagonal可重现 Word 默认的对角线水印方向，或使用Horizontal让水印平行于页面边缘。 - 在需要控制不透明度、缩放或字体时，优先使用
ImageWatermarkOptions/TextWatermarkOptions重载，而不是普通的SetImage(image)/SetText(text)调用——无参数的重载会使用 Word 的默认设置。
常见问题
| 问题 | 原因 | 修复 |
|---|---|---|
| 新水印未与旧水印一起显示 | SetText()/SetImage() 替换了现有的水印，而不是添加第二个 | 仅在需要在设置不同类型之前先清除它时才先调用 Remove()；否则替换会自动进行 |
| 图片水印压倒了页面内容 | ImageWatermarkOptions.IsWashout 被保持为禁用 | 在构建 ImageWatermarkOptions 时，将 IsWashout 设置为 true |
| 文字水印的字体与预期的字形不匹配 | TextWatermarkOptions.FontFamily 未设置（或拼写错误） | 将 FontFamily 设置为渲染环境中可用的字体名称 |
FAQ
我如何检查文档是否已经有水印？
读取 Document.Watermark.Type；它返回 WatermarkType.Text、WatermarkType.Image 或 WatermarkType.None。
我如何移除水印？
调用 Document.Watermark.Remove()。
我可以控制水印的透明度吗？
是的——对于文本水印，设置 TextWatermarkOptions.IsSemitrasparent；对于图像水印，设置 ImageWatermarkOptions.IsWashout。
我如何从磁盘加载图像水印，而不是使用内存中的 Image？
使用 Watermark.SetImage(imagePath, options) 重载，将文件路径作为字符串传入，并提供一个 ImageWatermarkOptions 实例。
API Reference 摘要
| 类 / 枚举 | 描述 |
|---|---|
Watermark | 文档水印，通过 Document.Watermark；SetText()、SetImage()、Remove()、Type |
WatermarkType | 枚举，标识当前水印类型：Text、Image、None |
WatermarkLayout | 枚举，用于水印方向：Horizontal、Diagonal |
TextWatermarkOptions | 文字水印格式: FontFamily, Color, FontSize, IsSemitrasparent, Layout |
ImageWatermarkOptions | 图片水印选项: Scale, IsWashout |
