次の方法で共有

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

  • [アーティクル]

更新 : 2007 年 11 月

この例では、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;

現在、テキストのトリミングでは、CharacterEllipsis、WordEllipsis、および None の 3 つのオプションを使用できます。

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

例 : TextTrimming.CharacterEllipsis

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

例 : TextTrimming.WordEllipsis

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

例 : TextTrimming.None

参照

処理手順

TextTrimming プロパティのサンプル