如何在 C# 中添加文本轮廓效果

在 C# 中添加文本轮廓效果可以在字符周围创建一个可见的边框，增强可读性和视觉效果。 使用 IronWord 的 TextOutlineEffect 类应用可自定义的轮廓，并对颜色、粗细和样式进行控制。 这种技术对于创建醒目的标题、水印或强调商业文档和报告中的重要内容尤为重要。

<! -- 待办事项：在此处添加图片 --> <! -- --> <！--说明：说明代码概念的图表或截图 -->

文本轮廓在文档设计中具有多种作用：提高复杂背景的对比度，创建视觉层次，为演示文稿和报告增添专业光彩。 无论您是生成发票、创建营销材料还是制作技术文档，文本大纲都能让您的内容更吸引人、更易读。

快速入门：立即应用默认文本轮廓效果

只需一行代码，即可创建一个TextStyle ，通过TextOutlineEffect.DefaultEffect应用现成的文本轮廓。 它无需进行复杂的设置即可增强文本效果。这种方法非常适合快速原型开发，或需要快速增强视觉效果而无需微调特定参数的情况。

如何在 Word 文档中添加文本大纲效果？

为什么要使用 TextOutlineEffect 进行文本样式设计？ 要指定文本的轮廓效果，请创建**TextStyle**对象，并使用**TextOutlineEffect**对象填充 TextOutlineEffect 属性。 最后，通过将**TextStyle**对象分配给 TextEffect 属性来添加具有该样式的新文本。 `TextOutlineEffect` 类提供了一个全面的 API，用于控制文本轮廓的各个方面。 与基本的文本格式选项不同，它提供对线条宽度、颜色、笔对齐和破折号样式等轮廓属性的细粒度控制。 在创建需要满足特定品牌准则或可访问性要求的专业文档时，这种控制水平至关重要。 在商业应用中，当在不同纸张上打印或在不同设备上查看文档时，文本大纲可以大大提高文档的可读性。 大纲在每个字符周围创建了一个缓冲区，确保即使在繁忙的背景或低对比度的情况下，文字仍然清晰可读。

添加大纲的基本代码模式是什么？ ```cs :path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs ```

该基本模式演示了应用文本大纲的基本方法。 代码将创建一个新文档，定义一个具有默认轮廓效果的文本样式，将其应用于文本并保存结果。 `DefaultEffect` 提供了一个平衡的大纲，适用于大多数场景，具有微妙的宽度和互补色，可增强而非淹没文本。

如何自定义文本轮廓效果属性？

哪些属性控制大纲外观？ 文本轮廓效果提供多种可自定义属性，以满足任何设计需求。 了解了这些特性，您就可以创建与文档的视觉要求和品牌准则完美匹配的大纲。 以下是各项属性及其描述： |属性|说明| |----------|-------------| |**笔对齐**|获取或设置笔的对齐方式。 控制大纲在文本内部、外部还是居中显示| |**LineCapType**线条类型|获取或设置用于轮廓效果的线帽类型。 选项包括影响行尾显示的平帽、圆帽或方帽| |**行宽**|获取或设置轮廓效果线的宽度。宽度以点（1/72 英寸）为单位指定。 典型值范围为 0.1 至 2.0| |**复合行类型**|获取或设置用于轮廓效果的复合线类型。 可创建双行、三行或其他多行大纲样式| |**LineJoin**|获取或设置用于轮廓效果的笔画连接样式。 确定轮廓角的连接方式（斜切、圆角或倒角）| |**颜色**|获取或设置轮廓效果的实心填充颜色。 可接受任何有效的颜色值，以获得最大的灵活性| |**PresetLineDash**|获取或设置大纲效果的预设破折号样式。 可选择实线、虚线、点线或自定义模式| 每个属性在创建专业外观的文本大纲时都有特定的用途。 例如，`LineWidth` 会直接影响视觉效果--较细的轮廓（0.1-0.3 点）会产生微妙的强调效果，而较粗的轮廓（1.0-2.0 点）则会产生大胆的表述。 `Color` 属性对于保持品牌一致性和确保足够的对比度以实现可访问性至关重要。

如何应用自定义大纲属性？ ```cs :path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs ```

这个高级示例展示了自定义大纲配置的全部功能。 代码以双线样式创建了一个独特的红色轮廓，展示了多个属性如何共同实现特定的视觉效果。 圆形线帽和斜角连接营造出流畅、专业的轮廓，非常适合标题和标题。 在生产应用程序中实施自定义大纲时，请考虑创建可重复使用的样式模板。 为不同的文档元素（标题、副标题、强调文本）定义标准的大纲配置，并将其存储为常量或配置设置。 这种方法可以确保文档生成管道的一致性，并在品牌准则发生变化时简化维护工作。 为获得最佳效果，请在不同的输出格式和查看条件下测试您的大纲效果。 在屏幕上看起来不错的内容可能需要在打印输出时进行调整。 在选择轮廓宽度和颜色时，要考虑打印机分辨率、纸张颜色和视距等因素。 IronWord 的 `TextOutlineEffect` 类具有灵活性，您可以根据输出要求以编程方式对这些参数进行微调。