Cómo: Habilitar el recorte de texto

En este ejemplo se muestran el uso y los efectos de los valores disponibles en la enumeración TextTrimming.

Ejemplo

En el ejemplo siguiente se define un elemento TextBlock con el atributo TextTrimming establecido.

<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 continuación se muestra cómo establecer la propiedad TextTrimming correspondiente mediante código.

            myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

En la actualidad existen tres opciones para recortar texto: CharacterEllipsis, WordEllipsis y None.

Cuando TextTrimming se establece en CharacterEllipsis, el texto se recorta y se continúa con puntos suspensivos en el carácter situado más próximo al borde de recorte. Este valor suele recortar el texto de modo que se ajuste más al límite de recorte, pero puede dar lugar al recorte parcial de palabras. En la ilustración siguiente se muestra el efecto de este valor en un objeto TextBlock similar al definido anteriormente.

Cuando TextTrimming se establece en WordEllipsis, el texto se recorta y se continúa con puntos suspensivos al final de la primera palabra completa más próxima al borde de recorte. Este valor no mostrará palabras parcialmente recortadas, pero no suele recortar el texto tan cerca del borde de recorte como el valor CharacterEllipsis. En la ilustración siguiente se muestra el efecto de este valor en el objeto TextBlock definido anteriormente.

Cuando TextTrimming se establece en None, no se recorta el texto. En este caso, el texto se corta simplemente en el límite del contenedor de texto primario. En la ilustración siguiente se muestra el efecto de este valor en un objeto TextBlock similar al definido anteriormente.