信息
您所需的主题如下所示。但此主题未包含在此库中。

TextBlock 类

更新:2007 年 11 月

提供用于显示少量流内容的轻量控件。

命名空间:  System.Windows.Controls
程序集:  PresentationFramework(在 PresentationFramework.dll 中)
用于 XAML 的 XMLNS: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>

内容模型: TextBlock 支持 Inline 流内容元素的承载和显示。 支持的元素包括 AnchoredBlockBoldHyperlinkInlineUIContainerItalicLineBreakRunSpanUnderline。有关更多信息,请参见 TextBlock 内容模型概述

TextBlock 设计为一个轻量控件,特别适用于将小部分流内容集成到 用户界面 (UI) 中。TextBlock 针对单行显示进行了优化,同时在显示较少行数的内容时也具有良好的性能表现。

TextBlock 没有针对需要显示较多行内容的情况进行优化;对于这类情况,从性能角度讲,与相应查看控件耦合在一起的 FlowDocument 是比 TextBlock 更好的选择。 在 TextBlock 之后,FlowDocumentScrollViewer 是下一个用于显示流内容的最轻量控件,它只提供一个具有最小 UI 的滚动内容区域。FlowDocumentPageViewer 针对流内容的“一次一页”查看模式进行了优化。 最后,FlowDocumentReader 具有最为丰富的流内容查看功能,但是相应地,它也是一个具有更高重量级的控件。

可通过 HorizontalContentAlignmentVerticalContentAlignment 属性在水平和垂直方向上对齐 TextBlock 中的文本。可通过 HorizontalAlignmentVerticalAlignment 属性对齐页面布局中的 TextBlock

下面的示例演示如何使用 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>


下图显示了此示例的呈现结果。

屏幕快照:TextBlock 和按钮

下面的示例演示如何以编程方式实现类似的结果。

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.";


此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

.NET Framework

受以下版本支持:3.5、3.0

社区附加资源

显示:
© 2015 Microsoft