可以根據Github拉取示例程序運行
GitHub程序演示地址（點擊直達）
也可以在本文資源中下載

1. TextBlock控件介紹

TextBlock是WPF中最基礎且使用最廣泛的控件之一，主要用于顯示文本內容。雖然它并不直接繼承自Control類（實際上繼承自FrameworkElement），但它的使用方式與其他控件相似。TextBlock是一個輕量級的文本顯示控件，相比Label控件，它更加簡單高效，特別適合顯示短小的文本或多行文本。

TextBlock控件的主要功能是顯示文本信息，它不具備邊框、背景等復雜樣式（雖然可以設置Background屬性），也沒有模板和觸發器，這使得它在資源消耗上比Label控件更加輕量。

2. TextBlock的基本用法

2.1 基本語法

在XAML中創建一個簡單的TextBlock控件：

<TextBlock Text="這是一個TextBlock控件"/>

或者使用開始和結束標簽之間的內容作為文本：

<TextBlock>這是另一種設置文本的方式</TextBlock>

2.2 在代碼中創建TextBlock

在C#代碼中動態創建TextBlock：

// 創建TextBlock實例
TextBlock textBlock = new TextBlock();
// 設置文本內容
textBlock.Text = "這是在代碼中創建的TextBlock";
// 設置其他屬性
textBlock.FontSize = 16;
textBlock.Foreground = new SolidColorBrush(Colors.Blue);
// 將TextBlock添加到容器中（例如Grid）
myGrid.Children.Add(textBlock);

3. TextBlock的常用屬性

TextBlock提供了多種屬性用于控制文本的顯示效果：

3.1 文本內容相關屬性

• Text：設置或獲取TextBlock的文本內容
• TextAlignment：設置文本的水平對齊方式（Left、Center、Right、Justify）
• TextWrapping：控制文本的換行方式（NoWrap、Wrap、WrapWithOverflow）
• TextTrimming：設置文本剪裁方式（None、CharacterEllipsis、WordEllipsis）

3.2 字體相關屬性

• FontFamily：設置字體家族
• FontSize：設置字體大小
• FontWeight：設置字體粗細（如Normal、Bold）
• FontStyle：設置字體樣式（如Normal、Italic）
• FontStretch：設置字體的拉伸（如Normal、Condensed、Expanded）

3.3 外觀相關屬性

• Foreground：設置文本顏色
• Background：設置背景色
• LineHeight：設置行高
• TextDecorations：設置文本裝飾（如下劃線Underline）

3.4 布局相關屬性

• Padding：設置內邊距
• Margin：設置外邊距
• HorizontalAlignment：水平對齊方式
• VerticalAlignment：垂直對齊方式

4. TextBlock文本格式化

4.1 使用Run元素進行內聯格式化

TextBlock支持通過使用內聯元素對文本的不同部分應用不同的格式：

<TextBlock><Run Text="這是" FontWeight="Bold"/><Run Text="不同格式" Foreground="Red" FontStyle="Italic"/><Run Text="的文本示例" FontSize="16"/>
</TextBlock>

4.2 其他內聯元素

除了Run元素外，TextBlock還支持其他內聯元素：

• Bold：粗體文本
• Italic：斜體文本
• Underline：下劃線文本
• Hyperlink：超鏈接
• LineBreak：換行
• InlineUIContainer：可以包含其他UIElement元素

示例：

<TextBlock>這是<Bold>粗體</Bold>文本，這是<Italic>斜體</Italic>文本<LineBreak/>這是第二行文本，包含<Hyperlink NavigateUri="https://www.example.com">超鏈接</Hyperlink>
</TextBlock>

5. 處理長文本

在實際應用中，我們經常需要處理各種長文本的情況，TextBlock提供了多種解決方案：

5.1 使用LineBreak手動換行

<TextBlock>這是第一行文本<LineBreak/>這是第二行文本<LineBreak/>這是第三行文本
</TextBlock>

5.2 使用TextWrapping自動換行

<TextBlock TextWrapping="Wrap" Width="200">這是一段很長的文本內容，當文本超出控件寬度時，會自動換行顯示，以確保文本內容完全可見。
</TextBlock>

5.3 使用TextTrimming截斷文本

<TextBlock TextTrimming="CharacterEllipsis" Width="150">這是一段很長的文本，超出部分將被截斷并顯示省略號...
</TextBlock>

6. 示例應用場景

6.1 基本文本顯示

<TextBlock Text="用戶名：" FontSize="14" Margin="5"VerticalAlignment="Center"/>

6.2 多樣式文本

<TextBlock Margin="10"><Run Text="WPF開發" FontWeight="Bold" FontSize="16"/><LineBreak/><Run Text="TextBlock控件" Foreground="Blue"/><LineBreak/><Run Text="可以顯示多種樣式的文本" FontStyle="Italic"/>
</TextBlock>

6.3 帶有超鏈接的文本

<TextBlock Margin="10">更多信息請訪問：<Hyperlink NavigateUri="https://learn.microsoft.com/zh-cn/dotnet/desktop/wpf/" RequestNavigate="Hyperlink_RequestNavigate">WPF官方文檔</Hyperlink>
</TextBlock>

// 在代碼中處理超鏈接點擊事件
private void Hyperlink_RequestNavigate(object sender, RequestNavigateEventArgs e)
{// 使用默認瀏覽器打開鏈接Process.Start(new ProcessStartInfo{FileName = e.Uri.AbsoluteUri,UseShellExecute = true});e.Handled = true;
}

7. TextBlock與TextBox的比較

特性	TextBlock	TextBox
主要用途	顯示文本	編輯文本
可編輯性	只讀	可編輯
資源消耗	輕量級	較重
默認外觀	無邊框	有邊框
文本選擇	不支持（默認情況）	支持
內聯格式化	支持多種內聯元素	不支持（除非使用RichTextBox）

8. TextBlock控件的優化與性能

8.1 優化建議

• 對于靜態文本，優先使用TextBlock而非Label
• 避免在TextBlock中放置過多文本內容
• 當需要顯示大量文本時，考慮使用RichTextBox或FlowDocument
• 對于固定寬度的TextBlock，總是設置TextWrapping屬性

8.2 性能考慮

// 優化大量TextBlock的創建
private void CreateOptimizedTextBlocks(Panel container, int count)
{// 為了提高性能，預先禁用布局更新container.BeginInit();for (int i = 0; i < count; i++){TextBlock textBlock = new TextBlock();textBlock.Text = $"文本塊 {i}";// 其他屬性設置container.Children.Add(textBlock);}// 完成后重新啟用布局更新container.EndInit();
}

9. 高級示例

9.1 創建帶格式化的TextBlock

<TextBlock Margin="10" LineHeight="25" TextAlignment="Justify"><Run FontWeight="Bold" FontSize="16">WPF TextBlock控件詳解</Run><LineBreak/><Run>TextBlock是WPF中用于顯示文本的基礎控件，具有輕量級、高效的特點。它支持多種格式化選項，包括字體、顏色、裝飾等。</Run><LineBreak/><Run FontStyle="Italic" Foreground="Gray">本文將詳細介紹TextBlock的各種功能和用法。</Run>
</TextBlock>

9.2 文本裝飾效果

TextBlock支持的文本裝飾有：None、Underline、Baseline、Strikethrough、Overline。

<StackPanel Margin="10"><TextBlock Text="普通文本" Margin="0,5"/><TextBlock Text="下劃線文本" TextDecorations="Underline" Margin="0,5"/><TextBlock Text="基線文本" TextDecorations="Baseline" Margin="0,5"/><TextBlock Text="刪除線文本" TextDecorations="Strikethrough" Margin="0,5"/><TextBlock Text="上劃線文本" TextDecorations="Overline" Margin="0,5"/>
</StackPanel>

9.3 使用漸變文本

<TextBlock Text="漸變文本效果" FontSize="20" FontWeight="Bold"><TextBlock.Foreground><LinearGradientBrush StartPoint="0,0" EndPoint="1,0"><GradientStop Color="Blue" Offset="0"/><GradientStop Color="Green" Offset="0.5"/><GradientStop Color="Red" Offset="1"/></LinearGradientBrush></TextBlock.Foreground>
</TextBlock>

10. 特殊用例與技巧

10.1 使文本可選擇

默認情況下，TextBlock中的文本不可選擇，但我們可以通過一些技巧使其可選：

// 在代碼中創建可選擇文本的TextBlock
TextBlock selectableTextBlock = new TextBlock();
selectableTextBlock.Text = "這是可以選擇的文本";
// 使文本可選擇
selectableTextBlock.IsHitTestVisible = true;
selectableTextBlock.Focusable = true;
selectableTextBlock.MouseDown += (s, e) => {if (e.ClickCount == 1) {((TextBlock)s).Focus();}
};

10.2 垂直文本顯示

TextBlock本身不直接支持垂直文本，但可以通過以下方法實現：

1. 使用RenderTransform旋轉TextBlock：

<TextBlock Text="垂直文本" FontSize="16"><TextBlock.RenderTransform><RotateTransform Angle="90"/></TextBlock.RenderTransform>
</TextBlock>

2. 利用窄寬度和TextWrapping屬性：

<TextBlock Text="這是垂直顯示的文本" Width="1" TextWrapping="Wrap"/>

10.3 實現文本陰影效果

<Grid><!-- 陰影文本 --><TextBlock Text="陰影文本效果" FontSize="24" FontWeight="Bold" Foreground="#50000000" Margin="2,2,0,0"/><!-- 前景文本 --><TextBlock Text="陰影文本效果" FontSize="24" FontWeight="Bold" Foreground="White"/>
</Grid>

11. 總結與擴展

TextBlock是WPF應用程序中不可或缺的基礎控件，它簡單、高效，但功能強大。通過本文的介紹，我們詳細了解了TextBlock的基本用法、屬性設置、文本格式化以及各種高級用法。

在實際應用中，需要根據具體需求選擇合適的文本顯示控件：

• 對于簡單的文本顯示，使用TextBlock
• 需要用戶輸入文本時，使用TextBox
• 需要顯示和編輯富文本時，使用RichTextBox
• 顯示大量格式化文檔時，使用FlowDocument相關控件

隨著WPF應用的發展，TextBlock控件也在不斷完善，了解并熟練使用這一基礎控件，對于開發高質量的WPF應用程序至關重要。

12. 學習資源

• 微軟官方文檔 - TextBlock類
• WPF TextBlock控件概述
• C# Corner - WPF TextBlock