Como habilitar o corte de texto

Este exemplo demonstra o uso e os efeitos dos valores disponíveis na enumeração TextTrimming.

Exemplo

O exemplo a seguir define um elemento TextBlock com o conjunto de atributos 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>

A definição da propriedade TextTrimming correspondente no código é demonstrada abaixo.

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

Atualmente, há três opções para cortar texto: CharacterEllipsis, WordEllipsis e Nenhum.

Quando TextTrimming é definido como CharacterEllipsis, o texto é cortado e continuado com uma reticência no caractere mais próximo da borda de corte. Essa configuração tende a cortar o texto para se ajustar mais de perto ao limite de corte, mas pode resultar em palavras sendo parcialmente cortadas. A figura a seguir mostra o efeito dessa configuração em um TextBlock semelhante ao definido acima.

Quando TextTrimming é definido como WordEllipsis, o texto é cortado e continua com reticências no final da primeira palavra completa mais próxima da borda de corte. Essa configuração não mostrará palavras parcialmente cortadas, mas tende a não cortar o texto tão próximo da borda de corte quanto a configuração CharacterEllipsis. A figura a seguir mostra o efeito dessa configuração no TextBlock definido acima.

Quando TextTrimming é definido como Nenhum, nenhum corte de texto é executado. Nesse caso, o texto é simplesmente recortado para o limite do contêiner de texto pai. A figura a seguir mostra o efeito dessa configuração em um TextBlock semelhante ao definido acima.