資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 可支援最豐富的設定功能來檢視非固定格式內容,但相對地也較重。

TextBlock 中的水平及垂直對齊文字作業,可藉由 HorizontalContentAlignmentVerticalContentAlignment 屬性來完成。在頁面配置中對齊 TextBlock 的作業,可藉由 HorizontalAlignmentVerticalAlignment 屬性來完成。

下列範例顯示如何使用 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.";


這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱 .NET Framework 系統需求

.NET Framework

支援版本:3.5、3.0

社群新增項目

顯示:
© 2015 Microsoft