WPF 筆記：文字佈局控件全解析 (TextBlock/TextFlow/Inline 元素)

WPF 提供豐富的文字佈局控件，從輕量的 TextBlock 到排版級的 TextFlow (即 FlowDocument)，滿足從簡單標籤到複雜文檔的多樣需求。

1. TextBlock：最基礎輕量文字控件

核心屬性

• 5 種 Font 屬性：FontFamily, FontSize, FontWeight, FontStyle, FontStretch。
• TextWrapping：Wrap (換行) / NoWrap (不換行，預設) — *原書標註有誤，此處更正*。
• TextAlignment：Left/Right/Center/Justify (兩端對齊)。

內容模型：不只是文字

TextBlock 內可直接放置**任意 UIElement** (非僅 Inline)，會按行內流佈局：

<TextBlock TextWrapping="Wrap">
  <Button>Split</Button>
  <CheckBox>across</CheckBox>
  <TextBox>multiple</TextBox>
  lines
</TextBlock>

Inline 元素豐富行內樣式

<TextBlock FontSize="18">
  <Run>This </Run>
  <Italic>is</Italic> 
  <Bold>rather</Bold>
  <Underline>messy</Underline>. 
  <Hyperlink NavigateUri="https://example.com">www.example.com</Hyperlink>
</TextBlock>

支援：Run, Bold, Italic, Underline, Hyperlink, Span 等。
AccessText (存取鍵提示) 效果不如預期；Subscript/Superscript 已廢棄。

2. Whitespace 處理：xml:space="preserve"

預設 TextBlock 忽略 XAML 中的換行/縮進 (視為單一空白)。保留原始格式需設定：

<TextBlock FontSize="18" xml:space="preserve">
  This is
  multi-line
  text.
</TextBlock>

也可局部套用：<Bold xml:space="preserve">...</Bold>。
建議：僅在直接複製大段文本時使用，正常開發用 <LineBreak/> 或 <Paragraph> 控制換行。

3. FlowDocument (原 TextFlow)：排版級文檔容器

功能遠超 TextBlock，提供 5 種區塊容器：

效能權衡

微軟白皮書明確指出：**TextBlock 效能遠高於 FlowDocument**。除非需要複雜排版 (分頁、欄位、註腳、浮動)，**優先使用 TextBlock**。
FlowDocument 適用場景：報表列印、電子書閱讀器、豐富文檔編輯器。

選擇指南

理解文字控件層級與效能特性，能在「輕量顯示」與「豐富排版」間做出正確架構決策。