Como habilitar filtragem de texto

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

Exemplo

O exemplo a seguir define um TextBlock elemento com o conjunto de TextTrimming atributos.

<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 correspondente TextTrimming no código é demonstrada abaixo.

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

Existem atualmente três opções para cortar texto: CharacterEllipsis, WordEllipsis e None.

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

Quando TextTrimming definido como WordEllipsis, o texto é cortado e continuado com uma reticência 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 à 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 similar ao definido acima.