方法: テキストトリミングを有効にする

この例では、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の 3 つのオプションがあります。

TextTrimming が CharacterEllipsisに設定されている場合、テキストはカットされ、トリミングエッジに最も近い文字は省略記号で表示されます。 この設定では、トリミング境界に近いサイズに合わせてテキストをトリミングする傾向がありますが、単語が部分的にトリミングされる可能性があります。 次の図は、上記で定義したものと同様の TextBlock に対するこの設定の効果を示しています。

が WordEllipsisに設定されている場合、テキストはトリミングされ、トリミングエッジに最も近い最初の完全な単語の末尾に省略記号が付きます。 この設定では、部分的にトリミングされた単語は表示されませんが、CharacterEllipsis 設定 ほどトリミングエッジに近いテキストをトリミングしない傾向があります。 次の図は、上記で定義した TextBlock に対するこの設定の効果を示しています。

が [なし]設定されている場合、テキストのトリミングは実行されません。 この場合、テキストは単に親テキスト コンテナーの境界にトリミングされます。 次の図は、上記で定義したものと同様の TextBlock に対するこの設定の効果を示しています。