Golang 开源 Excelize 基础库教程 2.1 单元格赋值、样式设置与图片图表的综合应用原创

大家好，欢迎收看X基础教程的第二章第一节，这一章会详细讲解xize的主要功能，通过实例学习如何借助xize提供的API能力实现Excel文档的读写。本节课将会讲解单元格、赋值、设置样式、添加表格、图表等方法，包括对X中15个API的使用，通过一个创建学生考试成绩统计表的例子，带大家学习如何使用X创建Excel报表。首先看一下这节课的目标，在这个学生考试成绩统计表中包含数据公式、合并单元格等功能。我们先来设置基本的数据，首先会用到创建工作簿、设置工作表名称、单元格、坐标组合、暗行赋值和另存为这五个API。在课程目录下创建一个第二章第一节的目录，然后把会用到的原数据和图片资料先准备好，然后打开Vs code的编辑器。

创建一个man do go文件，声明package名称为man，然后声明man方法。接下来我们调用ize提供的new file API创建一个新的工作簿，保存文件，然后打开终端。这里我们运行go in初始化模块，然后运行go Mo TY安装包依赖。接着我们声明一个工作表的一个名称为成绩单，然后我们修改默认的SHEET1工作表的名称。这里会用到第二个API set name。第一个参数是原工作表名称。我们把它修改为sheet name，接下来我们调用保存的方法，F对象上可以调用到saves，保存为book 1.xlsx文件，处理一下错误的返回值。好，我们保存文件运行。Go do go会生成一个不可一的工作簿，然后用Excel打开看一下。

啊，我们可以看到一个新的工作簿，里面包含一个名为成绩单的工作表。OK，接下来呢，我们来为单元格进行赋值，我们先说明一个二维数组，数组元素的类型为interface类型，这里面我先把预先准备好的数据粘贴过来，接着进行原数据的准备，为string类型的文本添加双引号。这里大家需要注意的是第一行的标题，考试成绩统计表和考试名称，基础科目、理科科目都是在合并单元格里的，由于合并单元格时呢，合并区域仅保留左上角单元格的值，其他单元格的值将被忽略，所以这里我们把其他单元格的值声明为零值那。在完成单元格数据的声明之后，我们遍历这个二维数组。按行赋值时，需要指定起始单元格坐标，使用join cell name进行计算。

接着调用set she row函数进行按行赋值。第一个参数是工作表名称，第二个参数是刚计算好的起始单元格start，第三个参数是数组的地址。然后保存运行这个程序。用Excel再打开，可以看到已经设置好了单元格的值。接着我们继续为单元格设置公式和合并单元格操作。这里用到了共享公式，它是存储公式的一种更高效的方法，将K4到K9区域的单元格设置为与K4共享公式SUM4G4来为每个学生计算总分，这样就不需要为每个学生对应的总分单元格依次设置公式了。保存代码，然后执行该程序。用Excel打开保存后的文档可以看到。已经设置好了公式，并且Excel可以自动计算单元格的值。

接着进行合并单元格操作，我们定义mece range为一个二维数组，声明四个合并单元格区域。然后遍历该二维数组。调用墨cel方法，依次声明工作表名称、单元格起始坐标和合并单元格结束坐标。保存代码之后运行go RA man go，打开所保存的BOOK1工作簿，可以看到合并单元格设置好了。接下来我们为单元格设置样式，并设置列的宽度。首先我们可以看到考试成绩统计表这个单元格，它的背景颜色为浅蓝色，并且文字样式为居中对齐我们。创建一个这样的样式，通过new style方法来进行创建。它的参数类型是style类型。

声明alignment来设置对齐方式，Horizontal为center，代表水平方向的对齐方式为居中对齐。file字段为pattern来声明纯色填充。填充颜色我们使用RGB的色值在color字段当中进行指定，这将返回一个STYLE1的样式ID，该ID可以被复用到其他的单元格上，接收并处理错误的返回值。接着调用set style style函数进行单元格样式的设置，通过声明工作表的名称和单元格区域的起始坐标、结束坐标和刚刚创建的样式ID来进行设置样式，保存代码，然后运行这段程序。再用Excel打开生成的文件，可以看到考试成绩统计表，这个单元格背景颜色和居中样式已经设置成功了，接着我们为合并单元格区域设置居中的样式。

首先还是通过new style方法创建一个文字居中的样式。获得style ID为STYLE2，接着将这个样式设置到三个合并区域单元格上。保存代码，执行该程序。打开生成的工作簿，可以看到合并单元格区域的样式已经设置好了。接着我们来设置列的宽度，我们调整从D到K这八列。列的宽度通过set column函数进行设置，这里我们设置列的宽度为七，设置完成后保存代码，运行该程序，重新打开文件可以看到。列的宽度已经设置好了，下面我们继续来创建表格和图表。在X当中呢，我们可以用at table函数来创建表格，使用at chart来创建图表。首先来创建一个表格，我们通过声明工作表名称和表格所在的区域坐标以及表格格式的参数来创建表格。

可以通过table name来指定表格名称。然后通过table style来创建声明表格的样式。我们这里使用浅色主题。然后接收并处理错误的返回值。接受保存并运行该程序，打开保存的文件，可以看到我们已经表格生成好了。我们接下来创建图表，通过ad叉的方法声明所在的工作表名称以及。图表所在的区域。第三个参数是图表的具体的格式参数，我们通过type来声明，创建一个柱状图表series来声明。

图表所引用的数据源区域。Format参数呢？可以指定图表的大小以及它的位置。比如说X scale，我们将图表横向拉伸为1.3倍的宽度，接收并处理char函数所返回的可能潜在的错误，保存并运行该文件。打开保存后的文档，我们可以看到已经为考试成绩生成了一个。图表，如果我们想关闭图表当中的图例项，我们关闭图例项的参数即可。

如果我们想添加图表的标题，通过title这个参数进行指定。我们可以看到，成绩单这个标题已经被。添加到图表当中了。接着，我们向工作表当中插入图片，并设置工作表的视图属性。通过提供的addd picture方法来插入图片。第一个参数是工作表名称，第二个参数为图片的左上角的单元格坐标，第三个参数呢是图片的路径，第四个参数是图片的格式属性，通过XO set来指定水平方向的偏移量。Y off set是垂直方向的便宜量。然后我们设置图表横纵向的缩放比例，缩放到原来尺寸的20%，接着接收并处理at picture方式所含返回的可能潜在的错误异常。因为我们插入的是PNG格式图片，我们还需要导入购物员的image官方包。

然后运行该程序，打开可以看到图片已经被插入到了对应的位置，然后我们来设置工作表的视图属性。通过调用所提供的set she view options API来设置工作表的视图属性，这里指定工作表名称、视图索引。以及相关的视图属性参数。这里我们调用show lines为false来关闭网格线，接收并处理可能返回的错误，保存并执行该程序。打开所生成的文档可以看到网格线已经被关闭。接下来我们为工作表设置窗格，冻结工作表的前三行，实现滚动学生成绩的时候，表头不变。我们通过ize给我们提供的set pens方法来设置窗格。首先第一个参数是工作表名称，第二个参数为窗格设置的相关参数，接收并处理返回的error，声明freeze为true来开启窗格冻结。

通过lit参数为。三来声明纵向冻结前三行。接着保存并运行该程序，打开所生成的文档，我们可以看到冻结行已经设置成功。好，那本节课就到这里，谢谢大家。