Cómo: Habilitar el recorte de texto

En este ejemplo se muestra 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 conjunto de atributos TextTrimming.

<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 describe cómo establecer la propiedad TextTrimming correspondiente en el código.

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis;

myTextBlock.TextTrimming = TextTrimming.CharacterEllipsis

Actualmente, existen tres opciones para recortar texto: CharacterEllipsis, WordEllipsis y None.

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

Ejemplo: TextTrimming.CharacterEllipsisTextTrimming_Character

Si TextTrimming se establece en WordEllipsis, el texto se recorta y 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 la opción CharacterEllipsis. En la imagen siguiente se muestra el efecto de esta opción en el objeto TextBlock definido anteriormente.

Ejemplo: TextTrimming.WordEllipsisTextTrimming_Word

Si TextTrimming se establece en None, no se realiza ningún recorte de texto. En este caso, el texto se recorta simplemente en el límite del contenedor de texto primario. En la imagen siguiente se muestra el efecto de esta opción en un objeto TextBlock similar al definido anteriormente.

Ejemplo: TextTrimming.NoneTextTrimming_None