WPF文档介绍(FlowDocument),并做打印输出

一、序论

WPF文档分为两大类,固定文档和流文档

固定文档是指已经排好版,准备打印的文档,所有内容的位置都是固定的,使用XPS(XML Paper Specification,XML页面规范)标准。对于需要以原封不动的格式进行打印的文档是很重要的(如表格和出版物)。

流文档是为在计算机上查看而设计的文档,内容会调整自身以适应容器。用于屏幕上阅读非常理想(如软件中的帮助)。

WPF通过使用不同容器为这两种类型的文档提供支持,固定文档的容器是DocumentViewer,流文档的容器时FlowDocumentReader、FlowDocumentPageViewer和FlowDocumentScrollViewer,本文主要流文档。

  • FlowDocumentReader:该容器显示整个文档,内容太多时自动使用滚动条移动文档,不支持分页和多列显示。
  • FlowDocumentPageViewer:该容器将流文档分成多页,FlowDocumentPageViewer的开销比FlowDocumentReader大。
  • FlowDocumentScrollViewer:允许滚动和分页,开销最大。

二、流文档

WPF流内容元素构成流文档,它主要由以下2部分组成:

Block元素(块元素)用于分组其他内容元素。

  • List
  • Paragraph
  • Section
  • Table
  • BlockUIContainer

Inline元素(内联元素)被嵌入到块级别元素的内联级别元素

  • Run
  • Span
  • LineBreak
  • InlineUIContainer
  • AchhoredBlock(Figure和Floater)

Block元素

设置内容元素格式的常用属性:LineHeight:为嵌套的文本内容设置行间距;TextAlignment:为嵌套的文本内容设置水平对齐方式(可以说Left、Right、Center)。

1.Paragraph它表示文本段落,技术上说段落不包含文本--而是包含内联级别元素的集合,存储在Paragraph.Inline集合中。TextIndent属性设置第一行的缩进量。

    <FlowDocumentScrollViewer>
        <FlowDocument>
            <Paragraph Name="paragraph">Hello this is China</Paragraph>
            <Paragraph>This is a second paragraph</Paragraph>
        </FlowDocument>
    </FlowDocumentScrollViewer>

 

((Run)paragraph.Inlines.FirstInline).Text="again";

2.List元素表示项目符号或数字列表,可以通过MarkerStyle属性进行选择。

            <Paragraph>Top program language</Paragraph>
            <List>
                <ListItem>
                    <Paragraph>C#</Paragraph>
                    <Paragraph>C++</Paragraph>
                </ListItem>
            </List>
            <Paragraph>To-do List</Paragraph>
            <List MarkerStyle="Decimal">
                <ListItem>
                    <Paragraph>WPF</Paragraph>                   
                </ListItem>
                <ListItem>
                    <Paragraph>Winform</Paragraph>
                </ListItem>
            </List>

3.Table元素

步骤:

在Table元素中放置TableRowGroup元素;TableRowGroup元素中为每一列添加TableRow元素;在每个TableRow元素中添加TableCell元素;在每个TableCell元素中放置块级别元素。

<Table BorderBrush="Black" BorderThickness="1">
                <Table.Columns>
                    <TableColumn Width="*"/>
                    <TableColumn Width="3*"/>
                    <TableColumn Width="*"/>
                </Table.Columns>
                <TableRowGroup Paragraph.TextAlignment="Left">
                    <TableRow FontWeight="Bold">
                        <TableCell BorderBrush="Black" BorderThickness="1">
                            <Paragraph>Rank</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>Name</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>Population</Paragraph>
                        </TableCell>
                    </TableRow>
                    <TableRow>
                        <TableCell>
                            <Paragraph>1</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>Rome</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>1000000</Paragraph>
                        </TableCell>
                    </TableRow>
                    <TableRow>
                        <TableCell>
                            <Paragraph>1</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>Luoyang(HuNan),China</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>3210000</Paragraph>
                        </TableCell>
                    </TableRow>
                    <TableRow>
                        <TableCell>
                            <Paragraph>1</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>Peshawar,pkeuysd</Paragraph>
                        </TableCell>
                        <TableCell>
                            <Paragraph>1003400</Paragraph>
                        </TableCell>
                    </TableRow>
                </TableRowGroup>
            </Table>
View Code

注:在没有为列提供明确的宽度时,wpf将为所有列平均分配空间。

4.Section元素

Section元素本身没有任何内置的格式化设置,而是用于在某个方便的包中封装其他块级别元素,方便为整个部分应用常用格式。          

<Section FontSize="20" Background="RED" Paragraph.LineHeight="1">
<Paragraph>this is first paragraph</Paragraph>
<Paragraph>this is second paragraph</Paragraph>
</Section>

5.BlockUIContainer元素

用来放控件。

        <BlockUIContainer>
                <Button HorizontalAlignment="Left" Name="hhhh" Content="this is BlockUIContainer"/>
            </BlockUIContainer>

内联元素

1.Run元素包含实际文本

<Paragraph>
    <Run>Hello World</Run>
</Paragraph>

Run会隐式创建

四、实际案例

参考:用WPF实现打印及打印预览 - guogangj - 博客园 (cnblogs.com)

设计的思路就是:文档模版(xaml)+数据(.net对象)

 三、固定文档

写入内存的XPS文档

        MemoryStream ms = new MemoryStream();//准备在内存中存储内容
            Package package = Package.Open(ms, FileMode.Create, FileAccess.ReadWrite);
            Uri DocumentUri = new Uri("pack://InMemoryDocument.xps");
            PackageStore.RemovePackage(DocumentUri);
            PackageStore.AddPackage(DocumentUri, package);
            XpsDocument xpsDocument = new XpsDocument(package, CompressionOption.Fast, DocumentUri.AbsoluteUri);

使用完XPS文档之后,可关闭流以释放内存。

一个完整的打印功能

//构造一个基于内存的xps document
            MemoryStream ms = new MemoryStream();
            Package package = Package.Open(ms, FileMode.Create, FileAccess.ReadWrite);
            Uri DocumentUri = new Uri("pack://InMemoryDocument.xps");
            PackageStore.RemovePackage(DocumentUri);
            PackageStore.AddPackage(DocumentUri, package);
            XpsDocument xpsDocument = new XpsDocument(package, CompressionOption.Fast, DocumentUri.AbsoluteUri);
            //将flow document写入基于内存的xps document中去
            XpsDocumentWriter writer = XpsDocument.CreateXpsDocumentWriter(xpsDocument);
            using (FileStream fs=File.Open(@"C:\Users\Yan\Desktop\WPF工程\WpfPrintDemo\OrderDocument.xaml", FileMode.Open))
            {
                FlowDocument flowDocument = (FlowDocument)XamlReader.Load(fs);
                writer.Write(((IDocumentPaginatorSource)flowDocument).DocumentPaginator);

                docViewer.Document = xpsDocument.GetFixedDocumentSequence();//界面DocumentViewer预览
                xpsDocument.Close();
                ms.Dispose();
            }
View Code

 

posted @ 2021-10-16 17:19  HelloWorld庄先生  阅读(4302)  评论(0编辑  收藏  举报