天踦爵
诗号：三年寻龙，十年点穴，肩负青囊走南北；三寸知息，十面洞心，掌握乾坤通天阙。

概述

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高级文档显示功能，可以满足大部分的功能实现，以上只是简单的说明和使用，具体还有很多的功能可供开发学习。持续学习，持续成长。加油！