HOW TO：啟用文字修剪

這個範例示範 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 上的效果 (與上面定義的項目類似)。