Como: Ativar 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 atributo TextTrimming definido.

<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, existem três opções para cortar texto: CharacterEllipsis, WordEllipsise None.

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 ao limite de corte, mas pode resultar em palavras 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 uma reticência no final da primeira palavra completa mais próxima da margem de corte. Essa configuração não mostrará palavras parcialmente cortadas, mas tende a não cortar o texto tão perto 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 até ao limite do contêiner de texto suposto. A figura a seguir mostra o efeito dessa configuração em um TextBlock semelhante ao definido acima.