Como: Habilitar Trimming de texto

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

Exemplo

O seguinte exemplo 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>

Definindo a propriedade TextTrimming correspondente no código é demonstrado abaixo.

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

Existem atualmente três opções para o aparamento de texto: CharacterEllipsis, WordEllipsis, and Nenhum.

Quando um TextTrimming é definido como CharacterEllipsis, o texto é quebrado e continuado com uma elipse no caractere mais próximo à quina de corte. Esta definição tende a quebrar o texto para encaixar mais apertadamente ao limite de quebra, mas pode resultar em palavras sendo parcialmente quebradas. A seguinte figura mostra o efeito desta definição em um TextBlock similar ao definido acima.

Quando o TextTrimming é definido como WordEllipsis, o texto é quebrado e continuado com uma elipse ao final da primeira palavra completa mais próxima à quina de corte. Esta definição não mostra palavras parcialmente quebradas, mas tende a não quebrar o texto de forma tão próxima à quina de corte quanto o CharacterEllipsis. A seguinte figura mostra o efeito desta definição em um TextBlock similar ao definido acima.

Quando TextTrimming é definido como None, nenhuma quebra de texto é realizada. Neste caso, o texto é simplesmente cortado no limite do contêiner de texto pai. A seguinte figura mostra o efeito desta definição em um TextBlock similar ao definido acima.

Consulte também

Tarefas

Exemplo de propriedade TextTrimming