如何：启用文本修整

此示例演示了 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;

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

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

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

当 TextTrimming 设置为 WordEllipsis 时，将对文本进行剪裁，并在最靠近剪裁边缘的第一个完整的单词结尾处使用省略号填充。 此设置不会导致单词部分剪裁，但是剪裁文本时不如 CharacterEllipsis 设置那样靠近剪裁边缘。 下图显示了在上述定义的 TextBlock 中此设置的效果。

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