[]
        
(Showing Draft Content)

填充模式

概述

默认情况下,GcExcel 在处理模板时,会插入空行,然后设置数据及样式,这样并不能完整的控制样式和布局。

对于希望提前定义好布局的情况,GcExcel 提供了两个属性,是您可以更好的控制报表的布局以及样式。

填充模式 FillMode (FM)

语法:

image

FillMode 属性可以设置为 Insert、Overwrite 或 OverwriteWithFormat。

  • Insert:(默认值)数据填充时,以空行的方式插入新单元格,并设置单元格中的数据和样式。

  • Overwrite (O): 数据填充时,延扩展方向,向单元格中填写数据,不插入空单元格,不修改样式。

  • OverwriteWithFormat (OF): 数据填充时,延扩展方向,向单元格中填写数据,不插入空单元格,但从模板单元格复制样式与单元格合并。

示例:

下面的模板示例记录了一个国家不同地区的电子商品电子商务销售情况,并使用 FillMode 属性中的 “overwrite” 设置。

您也可以下载Excel模板布局:

Excel 模板布局.xlsx

Excel template layout displaying fillmode property in template cell

数据源中的数据包含8行。GcExcel 处理模板布局后,Excel 报表如下所示:

Excel report output displaying result of using fillmode property in template cell

注意: 如果在模板布局中没有定义 FillMode 属性,则遵循默认值,等同于设置为 FM = Insert。

要查看 FillMode 设置为 OverwriteWithFormat 的结果,请参见示例

填充区域 FillRange (FR)

语法:

image

FillRange 属性,需要 FillMode 设置为 OverWrite 或者 OverWriteWithFormat。当数据源的数据超出固定布局区域时,GcExcel 会复制 FillRange 指定的区域,并在新复制的区域执行覆盖填充数据。

type=warning

注意: 当数据源中的数据溢出且没有设置 FillRange 属性时,将不会复制范围,而是数据将填充在现有行的范围区域下方。

示例:

下面的模板示例记录了电子商务的销售情况。在 Area 中使用 FillMode = OverWrite 和 FillRange = A12:D23。

您也可以通过下载模板,在本地尝试示例:

SetFillModeOverflow_模板.xlsx

overflow_template

数据源中的数据包含26行。FillRange = A12:D23 指定了12行,需要复制两次区域,来填充所有数据。

GcExcel 处理模板布局后,Excel 报表如下所示:

overflow_report