如何：启用文本修整

更新：2007 年 11 月

此示例演示 TextTrimming 枚举中可用值的用法和效果。

示例

下面的示例定义一个设置了 TextTrimming 属性的 TextBlock 元素。

<TextBlock 
  Name="myTextBlock" 
  Margin="20" Background="LightGoldenrodYellow" 
  TextTrimming="WordEllipsis" TextWrapping="NoWrap"
  FontSize="14"
>
  One<LineBreak/>
  two two<LineBreak/>
  Three Three Three<LineBreak/>
  four four four four<LineBreak/>
  Five Five Five Five Five<LineBreak/>
  six six six six six six<LineBreak/>
  Seven Seven Seven Seven Seven Seven Seven
</TextBlock>

下面演示如何在代码中设置相应的 TextTrimming 属性。

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

当前有三个文本修整选项：CharacterEllipsis、WordEllipsis 和 None。

如果将 TextTrimming 设置为 CharacterEllipsis，则会对文本进行修整，并在最靠近修整边缘的字符处使用省略号填充。 此设置旨在修整文本以更靠近修整边界，但这样会导致单词不完整。 下图演示此设置在类似于上述代码定义的 TextBlock 中的效果。

如果将 TextTrimming 设置为 WordEllipsis，则将修整文本，并在最靠近修整边缘的第一个完整的单词结尾处使用省略号填充。 此设置不会显示经过修整之后不完整的单词，但是修整文本时不会像 CharacterEllipsis 设置一样靠近修整边缘。 下图演示此设置在上述代码定义的 TextBlock 中的效果。

如果将 TextTrimming 设置为 None，则不执行文本修整。 在此情况下，只是将文本裁切到父文本容器的边界处。 下图演示此设置在类似于上述代码定义的 TextBlock 中的效果。

请参见

任务

TextTrimming 属性示例