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

この例では、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 の 3 つのオプションを使用できます。

TextTrimming を CharacterEllipsis に設定した場合、テキストが切り取られ、トリミング エッジに最も近い文字の位置に省略記号が挿入されます。 この設定では、トリミング境界により近い位置でテキストが切り取られます。ただし、単語の一部が切り取られる可能性があります。 次の図は、上記で定義したものと同様の TextBlock にこの設定を適用した場合の効果を示しています。

TextTrimming を WordEllipsis に設定した場合、テキストが切り取られ、トリミング エッジに最も近い位置にある最初の完全な単語の後に省略記号が挿入されます。 この設定では、部分的に切り取られた単語は表示されません。ただし、CharacterEllipsis 設定よりもトリミング エッジから離れた位置でテキストが切り取られます。 次の図は、上記で定義した TextBlock にこの設定を適用した場合の効果を示しています。

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