如何：启用文本修整

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

示例：

以下示例使用 TextBlock 属性集定义 TextTrimming 元素。

<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;

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

目前有三个选项可用于剪裁文本：CharacterEllipsis、WordEllipsis和 None。

当 TextTrimming 设置为 CharacterEllipsis 时，将对文本进行剪裁，并在最靠近剪裁边缘的字符处使用省略号填充。 此设置倾向于裁剪文字以更接近裁剪边界，但可能会导致文字部分被裁剪。 下图显示了在类似于上述定义的 TextBlock 中此设置的效果。

当 TextTrimming 设置为 WordEllipsis时，文本将被修剪，并在最靠近修剪边缘的第一个完整单词末尾添加省略号。 此设置不会导致单词部分剪裁，但是剪裁文本时不如 CharacterEllipsis 设置那样靠近剪裁边缘。 下图显示了此设置对上面定义的 TextBlock 的影响。

当 TextTrimming 设置为无时，不会执行任何文本修整。 在这种情况下，只会将文本裁切到父文本容器的边界。 下图显示了在类似于上述定义的 TextBlock 中此设置的效果。