文章目录
- 概述
- 一、块元素和内联元素
- 1.1 块元素（Block类）
- 1.2 内联元素（Inline类）
- 二、Paragraph元素
- 2.1 基本属性设置
- 2.2 将内联元素Inline添加到Inlines中
- 2.3 设置中西文字体不一样
- 三、Table元素
- 3.1 添加新的Table
- 3.2 添加列
- 3.3 添加行
- 3.4 设置隔行不同颜色
- 总结
天踦爵
诗号：三年寻龙，十年点穴，肩负青囊走南北；三寸知息，十面洞心，掌握乾坤通天阙。
概述
WPF中提供了FlowDocument类，用于高级文档功能（如分页和列）承载流内容和设置流内容格式，可以根据自己的需要进行在线编辑，是自定义显示样式，展示大段文章的绝佳利器。
FlowDocument的默认值DataTemplateFlowDocument包含一个 FlowDocumentReader ，如果使用 作为 XAML 文件中的根元素，则用于FlowDocument显示文档。
如果 FlowDocument 不是根元素，则可以在 、 FlowDocumentPageViewer或 FlowDocumentReader 控件中FlowDocumentScrollViewer显示文档。
还可以在 控件中RichTextBox编辑 FlowDocument 。
一、块元素和内联元素
1.1 块元素（Block类）
FlowDocument 为子内容强制实施强内容模型。 中包含的 FlowDocument 顶级子元素必须派生自 Block。 有效的顶级子元素包括：
- BlockUIContainer
- List
- Paragraph
- Section
- Table
1.2 内联元素（Inline类）
为所有内联流内容元素提供基类的抽象类，有效的子元素包括：
- Bold
- Figure
- Floater
- Hyperlink
- InlineUIContainer
- Italic
- LineBreak
- Run
- Span
- Underline
二、Paragraph元素
Paragraph是段落，可以承载其他的Inline元素。一个段落按照一个新行开始添加。
2.1 基本属性设置
- Background：背景颜色
- BorderBrush：边框颜色
- BorderThickness：边框线条
- FontFamily：字体
- FontSize：字体大小
- FontStretch：字体拉伸特性
- FontStyle：字体样式
- FontWeight：字体粗细
- Foreground：字体颜色
- Inlines：内联元素集合
- TextAlignment：文本对齐方式
- ToolTip：提示对象
2.2 将内联元素Inline添加到Inlines中
Inline inline = new Run();
paragraph.Inlines.Add(inline); // 添加内联元素
2.3 设置中西文字体不一样
// 西文字体 中文字体
FontFamily("Times New Roman,楷体");
开发文档中是这样介绍的：指定多个字体系列名称的字符串，每个名称用逗号分隔 (逗号后的任何空格将被忽略) 。 指定的第一个字体系列用作主要字体系列;后续字体系列用作回退系列，用于主要字体系列不可用或不适用的情况。 例如， “Arial, Century Gothic” 指定 Arial 作为主要字体系列，将 Century 哥特作为回退字体系列。
而设置中西文，我们需要将西文字体设置在前面，这样自当匹配到中文之后，就会采用第二个设置的中文字体，如果将中文字体放前面，那就会无法显示西文字体，因为中文字体中一般西文也有，而西文字体中很少有中文。
三、Table元素
Table元素类似于Grid元素，但是具体有更多的功能，总体来说Table元素非常接近于word中的表格，但是有一点就是没有垂直居中功能，有需要垂直居中的话需要另行处理。
3.1 添加新的Table
public static Table AddTable(FlowDocument flowDocument, double cellSpacing = 0)
{
Table table = new Table();
table.BorderThickness = new Thickness(0, 1, 0, 0);
table.BorderBrush = new SolidColorBrush(Colors.Black);
table.CellSpacing = cellSpacing;
table.Margin = new Thickness(0, 5, 0, 10);
flowDocument.Blocks.Add(table);
return table;
}
3.2 添加列
/// <summary>
/// 添加列
/// </summary>
public static void AddColumn(Table table, uint colCnt)
{
if (table == null) return;
for (int i = 0; i < colCnt; i++)
{
TableColumn column = new TableColumn();
table.Columns.Add(column);
}
}
3.3 添加行
Table需要保证至少有一个TableRowGroup的情况才能添加行数据，向其中添加行组合，然后将行添加到行组合中。
public static void AddRow(TableRowGroup rowGroup, params object[] datas)
{
if (rowGroup == null || datas == null) return;
TableRow row;
TableCell cell;
// row.
row = new TableRow();
rowGroup.Rows.Add(row);
for (int i = 0; i < datas.Length; i++)
{
cell = new TableCell();
cell.BorderThickness = new Thickness(0, 0, 0, 1);
cell.BorderBrush = new SolidColorBrush(Colors.Black);
cell.TextAlignment = TextAlignment.Center;
row.Cells.Add(cell);
BlockUIContainer blockUIContainer = new BlockUIContainer();
cell.Blocks.Add(blockUIContainer);
Grid grid = new Grid();
TextBlock textBlock = new TextBlock();
textBlock.VerticalAlignment = VerticalAlignment.Center;
textBlock.TextAlignment = TextAlignment.Center;
textBlock.HorizontalAlignment = HorizontalAlignment.Center;
grid.Children.Add(textBlock);
blockUIContainer.Child = grid;
if ((datas[i] as Paragraph) == null)
{
textBlock.Inlines.Add(Convert.ToString(datas[i]));
}
else
{
textBlock.Inlines.AddRange((datas[i] as Paragraph).Inlines);
}
}
}
3.4 设置隔行不同颜色
Table本身并没有直接实现隔行不同颜色，但是可以通过遍历行，对不同行进行颜色设置实现该功能。
/// <summary>
/// Set table color.
/// </summary>
/// <param name="table"></param>
public static void SetTableColor(Table table,SolidColorBrush mainBrush, SolidColorBrush underBrush)
{
if (table == null)
{
return;
}
for (int i = 0; i < table.RowGroups.Count; i++)
{
for (int rowIndex = 0; rowIndex < table.RowGroups[i].Rows.Count; rowIndex++)
{
table.RowGroups[i].Rows[rowIndex].Background = rowIndex % 2 == 0 ? mainBrush : underBrush;
}
}
}
总结
FlowDocument是WPF高级文档显示功能，可以满足大部分的功能实现，以上只是简单的说明和使用，具体还有很多的功能可供开发学习。持续学习，持续成长。加油！
