Información
El tema que ha solicitado se muestra abajo. Sin embargo, este tema no se encuentra en la biblioteca.

TextBlock (Clase)

Actualización: noviembre 2007

Proporciona un control ligero que permite mostrar pequeños fragmentos de contenido dinámico.

Espacio de nombres:  System.Windows.Controls
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/xaml/presentation

[ContentPropertyAttribute("Inlines")]
[LocalizabilityAttribute(LocalizationCategory.Text)]
public class TextBlock : FrameworkElement, IContentHost, 
	IAddChild, IServiceProvider
/** @attribute ContentPropertyAttribute("Inlines") */
/** @attribute LocalizabilityAttribute(LocalizationCategory.Text) */
public class TextBlock extends FrameworkElement implements IContentHost, 
	IAddChild, IServiceProvider
public class TextBlock extends FrameworkElement implements IContentHost, IAddChild, IServiceProvider
<TextBlock>
  Inlines
</TextBlock>

Modelo de contenido:TextBlock puede hospedar y mostrar elementos de contenido dinámico Inline. Entre los elementos que admite se incluyen AnchoredBlock, Bold, Hyperlink, InlineUIContainer, Italic, LineBreak, Run, Span y Underline. Para obtener más información, vea Información general sobre el modelo de contenido de TextBlock.

TextBlock se ha diseñado para que sea ligero y se ha preparado específicamente para integrar pequeños fragmentos de contenido dinámico en una interfaz de usuario (UI). TextBlock proporciona un rendimiento óptimo en la presentación de líneas únicas y un rendimiento apropiado en la presentación de hasta unas pocas líneas de contenido.

TextBlock no se ha preparado para aquellos casos en los que es necesario mostrar más que unas pocas líneas de contenido; en esos casos, resulta más conveniente, en términos de rendimiento, utilizar FlowDocument junto con un control de presentación adecuado en lugar de TextBlock. Después de TextBlock, FlowDocumentScrollViewer es el siguiente control más ligero que permite mostrar contenido dinámico y simplemente proporciona un área de contenido con desplazamiento mediante una interfaz de usuario mínima. FlowDocumentPageViewer resulta el control óptimo para ver el contenido dinámico en el modo de vista de "una página a la vez". Por último, FlowDocumentReader admite la funcionalidad definida más completa para ver el contenido dinámico, pero, en consecuencia, es más pesado.

La alineación horizontal y vertical de texto en TextBlock se realiza mediante las propiedades HorizontalContentAlignment y VerticalContentAlignment. La alineación de TextBlock en el diseño de la página se realiza mediante las propiedades HorizontalAlignment y VerticalAlignment.

En el siguiente ejemplo se muestra cómo se utiliza el elemento TextBlock.

<TextBlock Name="textBlock1" TextWrapping="Wrap">
  <Bold>TextBlock</Bold> is designed to be <Italic>lightweight</Italic>,
  and is geared specifically at integrating <Italic>small</Italic> portions
  of flow content into a UI.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>
<TextBlock  Name="textBlock2" 
  TextWrapping="Wrap" Background="AntiqueWhite" TextAlignment="Center"
>
  By default, a TextBlock provides no UI beyond simply displaying its contents.
</TextBlock>
<Button Width="100" Margin="10">Click Me</Button>


En la ilustración siguiente se muestra cómo se representa este ejemplo.

Captura de pantalla: TextBlocks y botones

En el ejemplo siguiente se muestra cómo se puede obtener el mismo resultado mediante programación.

TextBlock textBlock1 = new TextBlock();
TextBlock textBlock2 = new TextBlock();

textBlock1.TextWrapping = textBlock2.TextWrapping = TextWrapping.Wrap;
textBlock2.Background = Brushes.AntiqueWhite;
textBlock2.TextAlignment = TextAlignment.Center;

textBlock1.Inlines.Add(new Bold(new Run("TextBlock")));
textBlock1.Inlines.Add(new Run(" is designed to be "));
textBlock1.Inlines.Add(new Italic(new Run("lightweight")));
textBlock1.Inlines.Add(new Run(", and is geared specifically at integrating "));
textBlock1.Inlines.Add(new Italic(new Run("small")));
textBlock1.Inlines.Add(new Run(" portions of flow content into a UI."));

textBlock2.Text =
    "By default, a TextBlock provides no UI beyond simply displaying its contents.";


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0

Adiciones de comunidad

Mostrar:
© 2014 Microsoft