Procedura: attivare l'enumerazione TextTrimming

In questo esempio vengono illustrati l'utilizzo e gli effetti dei valori disponibili nell'enumerazione TextTrimming.

Esempio

Nell'esempio seguente viene definito un elemento TextBlock con l'attributo TextTrimming impostato.

<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>

Di seguito viene illustrata l'impostazione della proprietà TextTrimming corrispondente in codice.

            myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

Attualmente sono disponibili tre opzioni per il taglio del testo: CharacterEllipsis, WordEllipsis e None.

Se TextTrimming è impostato su CharacterEllipsis, il testo viene tagliato e in corrispondenza del carattere più vicino al bordo del taglio vengono inseriti dei puntini di sospensione. Tale impostazione consente di tagliare il testo in modo da adattarlo meglio al limite di taglio, ma potrebbe determinare la troncatura delle parole. Nell'immagine seguente vengono mostrati gli effetti di questa impostazione su un oggetto TextBlock analogo a quello definito in precedenza.

Se TextTrimming è impostato su WordEllipsis, il testo viene tagliato e alla fine della prima parola completa più vicina al bordo del taglio vengono inseriti dei puntini di sospensione. Grazie a questa impostazione le parole non risulteranno tronche, ma non è possibile tagliare il testo in prossimità del bordo di taglio come consentito dall'impostazione CharacterEllipsis. Nell'immagine seguente vengono mostrati gli effetti di questa impostazione sull'oggetto TextBlock definito in precedenza.

Quando TextTrimming è impostato su None, non viene eseguita alcuna operazione di taglio del testo. In questo caso, viene eseguita una semplice operazione di ritaglio in corrispondenza del limite del contenitore di testo padre. Nell'immagine seguente vengono mostrati gli effetti di questa impostazione su un oggetto TextBlock analogo a quello definito in precedenza.