## **Table类**
在做项目的过程中，经常会遇到要把报表导出到Word文件中再打印的情况，而既然是做报表那就免不了要用到表格，即需要在Word文件中插入table。因此，PageOffice开发平台中就添加了此功能。
### **Table类的命名空间**
------
Table类进行写入操作时
* Java开发时命名空间为：com.zhuozhengsoft.pageoffice.wordwriter
* ASP.NET开发时命名空间为：PageOffice.WordWriter
Table类进行读取操作时
* Java开发时命名空间为：com.zhuozhengsoft.pageoffice.wordreader
* ASP.NET开发时命名空间为：PageOffice.WordReader
### **Table类的使用**
------
Word中的table是要借助数据区域（DataRegion）实现的，要求数据区域完整的包含了整个Table的内容，这样才可以通过数据区域控制和操作table。因此，要想使用table需在word文件中插入书签（数据区域及书签的添加使用与实现方法前面已经详细介绍过了此处不再赘述）。而table的插入，既可以在Word模版中书签处手动插入：工具栏“插入”→“表格”，亦可以在程序中通过数据区域添加。
同时，Table既可以对齐进行设置和赋值又可以从Table中取值
* **对Table进行设置和赋值（写入操作）的方法如下：**
**方法一**：先在Word模版文件中手动插入书签，如命名为“PO_regTable”，然后在此处手动插入table。
Java部分代码如下：
~~~
WordDocument doc = new WordDocument();
DataRegion dataRegion = doc.openDataRegion("PO_regTable");
//打开table，openTable(index)方法中的index代表Word文档中要打开的table位置的索引，从1开始
Table table = dataRegion.openTable(1);
//给table中的单元格赋值， openCellRC(int,int)中的参数分别代表第几行、第几列，下标从1开始
table.openCellRC(3, 1).setValue("A公司");
table.openCellRC(3, 2).setValue("开发部");
table.openCellRC(3, 3).setValue("李四");
//在某个个单元格下面插入一个空行
table.insertRowAfter(table.openCellRC(3, 3));
table.openCellRC(4, 1).setValue("B公司");
table.openCellRC(4, 2).setValue("销售部");
table.openCellRC(4, 3).setValue("张三");
poCtrl1.setWriter(doc);//不要忘记此句
... ...
~~~
ASP.NET部分实现代码如下
~~~
PageOffice.WordWriter.WordDocument doc = new PageOffice.WordWriter.WordDocument();
PageOffice.WordWriter.DataRegion dataRegion = doc.OpenDataRegion("PO_regTable");
PageOffice.WordWriter.Table table = dataRegion.OpenTable(1);
table.OpenCellRC(3, 1).Value = "A公司";
table.OpenCellRC(3, 2).Value = "开发部";
table.OpenCellRC(3, 3).Value = "李清";
table.InsertRowAfter(table.OpenCellRC(3, 3)); //插入一行
table.OpenCellRC(4, 1).Value = "B公司";
table.OpenCellRC(4, 2).Value = "销售部";
table.OpenCellRC(4, 3).Value = "张三";
PageOfficeCtrl1.SetWriter(doc);//不要忘记此行
... ...
~~~
上述示例的详细代码可参见PageOffice示例包中高级功能中的第14个示例：“向Word文档中的Table插入新行并赋值（专业版、企业版）”。
**方法二**：先在Word模版文件中手动插入书签，如命名为“PO_regTable”，然后程序插入table。部分实现代码如下：
Java代码（命名空间同方法一中相同）：
~~~
WordDocument doc = new WordDocument();
DataRegion dataRegion = doc.openDataRegion("PO_regTable");
//插入table，createTable方法中的三个参数分别代表插入表格的列数、行数、自动调整表格大小的方式。
Table table=dataRegion.createTable(3,3,WdAutoFitBehavior.wdAutoFitFixed);
table.openCellRC(3, 1).setValue("A公司");
table.openCellRC(3, 2).setValue("开发部");
table.openCellRC(3, 3).setValue("李清");
... ...
poCtrl1.setWriter(doc);//不要忘记此句
... ...
~~~~
ASP.NET实现代码如下（命名空间同方法一中相同）：
~~~
PageOffice.WordWriter.WordDocument doc = new PageOffice.WordWriter.WordDocument();
PageOffice.WordWriter.DataRegion dataRegion = doc.OpenDataRegion("PO_regTable");
//插入一个4行3列的表格
PageOffice.WordWriter.Table table = dataRegion.CreateTable(3, 4,
PageOffice.WordWriter.WdAutoFitBehavior.wdAutoFitFixed);
table.OpenCellRC(3, 1).Value = "A公司";
table.OpenCellRC(3, 2).Value = "开发部";
table.OpenCellRC(3, 3).Value = "李清";
... ...
PageOfficeCtrl1.SetWriter(doc);//不要忘记此行
... ...
~~~
以上是实现对Table的设置和赋值。
>[info]在PageOffice中不仅能对Table进行设置和赋值，还能从Table中取值。一般来说不推荐使用从Word表格中获取数据，因为实现此功能时，PageOffice并不能保护Table的表格结构，如果用户操作时破坏了表格的结构，那么获取表格数据的程序肯定会出现异常。
* **从Table中取值（读取操作）方法如下：**
Java代码：
~~~Java
WordDocument doc = new WordDocument(request,response); //注意Java中这句和设置Table时的不同
DataRegion dataRegion = doc.openDataRegion("PO_regTable");
Table table = dataRegion.openTable(1); //获取Table，参数为table的索引
Cell cell = table.openCellRC(2,3); //获取某个Cell对象，参数分别指table中的行和列索引
List<Cell> cells = table.getCells(); //获取Cell对象集合
Cell cell2 = (Cell)table.getCells().get(1); //获取Cell对象集合中的某个Cell对象
int columnCount = table.getColumnsCount(); //获取表格的列数
int rowCount = table.getRowsCount(); //获取表格的行数
int index = table.getIndex(); //Word中当前Table的索引
... ...
~~~
ASP.NET代码：
~~~
WordDocument doc = new WordDocument();
PageOffice.WordReader.DataRegion dataRegion = doc.OpenDataRegion("PO_regTable");
PageOffice.WordReader.Table table = dataRegion.OpenTable(1); //获取Table，参数为table的索引
Cell cell = table.OpenCellRC(3,2); //获取某个Cell对象，参数分别指table中的行和列索引
ArrayList cells = table.Cells; //获取Cell对象集合
Cell cell2 = (Cell)table.Cells[2]; //获取Cell对象集合中的某个Cell对象
... ...
~~~
* **Table的样式**
在PageOffice开发平台下不仅能向Word中插入table，还能对插入的table进行样式的设置（写入操作）。
①、设置table的宽度，以磅为单位或以窗口宽度的百分比表示，取决于属性PreferredWidthType( wdPreferredWidthAuto： 基于当前所选内容自动选择要使用的度量单位、wdPreferredWidthPercent：使用指定的百分比测量当前项目的宽度、wdPreferredWidthPoints：使用指定的磅数测量当前项目的宽度)的值。
Java代码：
~~~
table.setPreferredWidth(0.8f);//参数类型：float
table.setPreferredWidthType(WdPreferredWidthType.wdPreferredWidthPercent);
~~~
ASP.NET代码：
~~~
table.PreferredWidth = 200f;//参数类型：float
table.PreferredWidthType= PageOffice.WordWriter.WdPreferredWidthType.wdPreferredWidthPoints;
~~~
②、设置行高、列宽
Java代码：
~~~
table.setRowsHeight(20f);// 设置所有行的行高
//设置某一行的行高，注意第二个参数对table的行高显示结果的影响，详细请参考服务器端的开发帮助手册。
table.openRow(2).setHeight(10f,WdRowHeightRule.wdRowHeightExactly);
//设置某一列的列宽，注意第二个参数对table的列宽显示结果的影响，详细请参考服务器端的开发帮助手册。
table.openColumn(1).setWidth(25f, WdRulerStyle.wdAdjustNone);
~~~
ASP.NET代码：
~~~
table.SetRowsHeight(60f, PageOffice.WordWriter.WdRowHeightRule.wdRowHeightExactly);
//设置某一行的行高，注意第二个参数对table的行高显示结果的影响，详细请参考服务器端的开发帮助手册。
table.OpenRow(2).SetHeight(100f,PageOffice.WordWriter.WdRowHeightRule.wdRowHeightExactly);
//设置某一列的列宽，注意第二个参数对table的列宽显示结果的影响，详细请参考服务器端的开发帮助手册。
table.OpenColumn(2).SetWidth(180f, PageOffice.WordWriter.WdRulerStyle.wdAdjustProportional);
~~~
③、设置边框的样式
Java代码：
~~~
table.getBorder().setBorderType(WdBorderType.wdAllEdges); //边框类型
table.getBorder().setLineColor(Color.RED); //边框颜色
table.getBorder().setLineStyle(WdLineStyle.wdLineStyleDashDot); //边框线样式
table.getBorder().setLineWidth(WdLineWidth.wdLineWidth225pt); //边框线宽度
~~~
ASP.NET代码：
~~~
table.Border.BorderType = PageOffice.WordWriter.WdBorderType.wdAllEdges; //边框类型
table.Border.LineColor = Color.Green; //边框颜色
table.Border.LineStyle = PageOffice.WordWriter.WdLineStyle.wdLineStyleDashDotStroked;//边线样式
table.Border.LineWidth = PageOffice.WordWriter.WdLineWidth.wdLineWidth225pt; //边框线宽度
~~~
* **Table、Column、Row、Cell之间的关联**
Column、Row、Cell是PageOffice开发平台中的类，这三者是Table的重要组成部分。Column、Row、Cell这三个类对象的定义都是通过Table类实现的，通过对这三个类对象的设置可以使Table的内容更加的丰富和完善。
- 序言
- 产品简介
- PageOffice试用版和和正式版的区别
- PageOffice对客户端的要求
- PageOffice客户端安装步骤
- PageOffice常用功能与工作原理
- OA系统中的文档在线编辑及流转
- 痕迹保留、键盘批注、手写批注
- 文件并发控制功能
- 与数据库的关系
- SaveDataPage和SaveFilePage的区别
- 调用ZoomSeal签章系统中的印章
- 使用RunMacro运行Office的宏
- 为什么采用弹窗方式打开文件
- POBrowser弹窗方式的具体使用
- Word篇
- 常用接口对象
- WordDocument类
- DataRegion类
- DataTag类
- Paragraph类
- Shape类
- Table类
- Column类
- Row类
- Cell类
- WaterMark类
- DataRegion与DataTag的区别
- 编辑模板中的数据区域
- 动态填充Word文档
- 动态插入Word表格
- 动态创建数据区域
- 数据区域点击事件
- 实现Word文档编辑区域控制
- Word文档全文检索
- Word文件版本对比功能
- 实现用户自定义Word模板
- 实现多个Word文件合并
- Excel篇
- 常用接口对象
- Workbook类
- Sheet类
- Table类
- Cell类
- 动态填充Excel文档
- Excel指定单元格点击事件
- 实现用户自定义Excel模板
- 读取Excel文档中的数据
- 隐藏Excel的行号列标
- Java篇
- PageOffice集成说明
- 动态生成Word文件
- 给Word中的Table赋值
- 动态生成Excel文件
- Maven项目中引用PageOffice
- FileMaker组件功能简介
- ASP.NET篇
- PageOffice集成说明
- 给Word中的Table赋值
- 动态生成Word文档
- FileMaker组件功能简介
- 其他
- POPDF组件功能简介
- PPT相关功能简介
- 实现多人同时编辑一份文档
- PageOffice与Apache POI的区别
- 如何录制宏和编辑宏
- PDF篇
- PDF盖章