如何：啟用文字修剪

此範例示範 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 上的效果。