AutoColor

Font.AutoColor property

返回用于“自动颜色”的文本的当前计算颜色（黑色或白色）。 如果颜色不是“自动”，则返回Color.

public Color AutoColor { get; }

评论

当文本设置为“自动颜色”时，文本的实际颜色会自动计算 ，使其与背景色相呼应，清晰易读。当您更改背景颜色时， 文本颜色会在 MS Word 中自动切换为黑色或白色，以最大限度地提高可读性。

例子

展示如何根据背景亮度自动选择文本颜色来提高可读性。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 如果运行的 Font 对象未指定文本颜色，它将自动
// 根据背景颜色选择黑色或白色。
Assert.AreEqual(Color.Empty.ToArgb(), builder.Font.Color.ToArgb());

// 文本默认颜色为黑色。如果背景颜色较暗，黑色文本将难以看清。
// 为了解决这个问题，AutoColor 属性将以白色显示此文本。
builder.Font.Shading.BackgroundPatternColor = Color.DarkBlue;

builder.Writeln("The text color automatically chosen for this run is white.");

Assert.AreEqual(Color.White.ToArgb(), doc.FirstSection.Body.Paragraphs[0].Runs[0].Font.AutoColor.ToArgb());

// 如果我们把背景改为浅色，黑色会更
// 适合文本颜色而不是白色，以便自动颜色将其显示为黑色。
builder.Font.Shading.BackgroundPatternColor = Color.LightBlue;

builder.Writeln("The text color automatically chosen for this run is black.");

Assert.AreEqual(Color.Black.ToArgb(), doc.FirstSection.Body.Paragraphs[1].Runs[0].Font.AutoColor.ToArgb());

doc.Save(ArtifactsDir + "Font.SetFontAutoColor.docx");

也可以看看

Font.AllCaps Font.Bidi