Go Excelize API源码阅读GetPageLayout及SetPageMargins
更新时间：2022年08月18日 15:15:26 作者：丘山子
这篇文章主要为大家介绍了Go Excelize API源码阅读GetPageLayout及SetPageMargins的方法示例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
一、Go-Excelize简介
Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。
- 可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。
- 支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。
- 可应用于各类报表平台、云计算、边缘计算等系统。
使用本类库要求使用的 Go 语言为 1.15 或更高版本。
二、 GetPageLayout
func (f *File) GetPageLayout(sheet string, opts ...PageLayoutOptionPtr) error
根据给定的工作表名称和页面布局参数获取工作表的页面布局属性。
- 通过 PageLayoutOrientation 方法获取页面布局方向
- 通过 PageLayoutPaperSize 方法获取页面纸张大小 例如，获取名为 Sheet1 的工作表页面布局设置：
f := excelize.NewFile()
const sheet = "Sheet1"
var (
orientation excelize.PageLayoutOrientation
paperSize excelize.PageLayoutPaperSize
)
if err := f.GetPageLayout("Sheet1", &orientation); err != nil {
fmt.Println(err)
}
if err := f.GetPageLayout("Sheet1", &paperSize); err != nil {
fmt.Println(err)
}
fmt.Println("Defaults:")
fmt.Printf("- orientation: %q\n", orientation)
fmt.Printf("- paper size: %d\n", paperSize)
输出结果如下：
Defaults:
- orientation: "portrait"
- paper size: 1
废话少说，我们来看一看源码：
// GetPageLayout provides a function to gets worksheet page layout.
//
// Available options:
// PageLayoutOrientation(string)
// PageLayoutPaperSize(int)
// FitToHeight(int)
// FitToWidth(int)
func (f *File) GetPageLayout(sheet string, opts ...PageLayoutOptionPtr) error {
s, err := f.workSheetReader(sheet)
if err != nil {
return err
}
ps := s.PageSetUp
for _, opt := range opts {
opt.getPageLayout(ps)
}
return err
}
选项参数有4个，分别是PageLayoutOrientation(string)、PageLayoutPaperSize(int)、FitToHeight(int)、FitToWidth(int)。 源码逻辑很简单，读取工作表，然后获取工作表的PageSetUp字段，它是*xlsxPageSetUp类型的。
下图是xlsxPageSetUp类型的具体情况。可以看到它具有这么多结构体成员变量。
然后是遍历不定长变量opts，对于每个参数执行对应的操作。
....
如此，对每个参数都执行相应的方法之后，我们就将获取到的值存在了参数之中，因为从头到尾都是对参数的指针进行操作。
三、SetPageMargins
func (f *File) SetPageMargins(sheet string, opts ...PageMarginsOptions) error
根据给定的工作表名称和页边距参数设置工作表的页边距。页边距可选参数：
| 参数 | 数据类型 |
|---|---|
| PageMarginBotom | float64 |
| PageMarginFooter | float64 |
| PageMarginHeader | float64 |
| PageMarginLeft | float64 |
| PageMarginRight | float64 |
| PageMarginTop | float64 |
例如，设置名为 Sheet1 的工作表页边距:
f := excelize.NewFile()
const sheet = "Sheet1"
if err := f.SetPageMargins(sheet,
excelize.PageMarginBottom(1.0),
excelize.PageMarginFooter(1.0),
excelize.PageMarginHeader(1.0),
excelize.PageMarginLeft(1.0),
excelize.PageMarginRight(1.0),
excelize.PageMarginTop(1.0),
); err != nil {
fmt.Println(err)
}
该API源码如下：
// SetPageMargins provides a function to set worksheet page margins.
//
// Available options:
// PageMarginBottom(float64)
// PageMarginFooter(float64)
// PageMarginHeader(float64)
// PageMarginLeft(float64)
// PageMarginRight(float64)
// PageMarginTop(float64)
func (f *File) SetPageMargins(sheet string, opts ...PageMarginsOptions) error {
s, err := f.workSheetReader(sheet)
if err != nil {
return err
}
pm := s.PageMargins
if pm == nil {
pm = new(xlsxPageMargins)
s.PageMargins = pm
}
for _, opt := range opts {
opt.setPageMargins(pm)
}
return err
}
先读取工作表，然后获取PageMargins字段。
如果这个字段为空，就新建一个xlsxPageMargins对象，给s.PageMargins。
for _, opt := range opts {
opt.setPageMargins(pm)
}
然后对根据opt的类型，对pm指针进行操作。
等等...
一如既往的这些操作...
以上就是Go Excelize API源码阅读GetPageLayout及SetPageMargins的详细内容，更多关于Go Excelize API源码阅读的资料请关注脚本之家其它相关文章！
相关文章
go语言在请求http时加入自定义http header的方法
这篇文章主要介绍了go语言在请求http时加入自定义http header的方法,实例分析了Go语言http请求的原理与操作技巧,需要的朋友可以参考下2015-03-03
这篇文章主要为大家介绍了go语言的变量定义示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-12-12
这篇文章主要介绍了使用腾讯云go sdk 查询对象存储中最新文件,这包括如何创建COS客户端,如何逐页检索对象列表,并如何对结果排序以找到最后更新的对象,我们还展示了如何优化用户体验,通过实时进度更新和检索多个文件来改进程序,需要的朋友可以参考下2024-03-03
本文详细讲解了Go语言之嵌入类型，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-07-07
在本教程中，我们将学习如何在 Golang 中执行shell命令（如 ls、mkdir 或 grep ），我们还将学习如何通过 stdin 和 stdout 传递 I/O 到正在运行的命令，以及管理长时间运行的命令，感兴趣的同学可以借鉴一下2023-05-05
这篇文章主要介绍了详解Golang使用MongoDB通用操作,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-12-12
这篇文章主要为大家详细介绍了Go语言内存分配之结构体优化技巧的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下2023-11-11
本文将介绍Go语言中的值赋值和引用赋值,并比较它们之间的差异,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2023-10-10
这篇文章主要给大家介绍了关于Golang中如何使用lua进行扩展的相关资料，这是最近在工作中遇到的一个问题，觉着有必要分享出来给大家学习，文中给出了详细的示例，需要的朋友可以参考借鉴，下面来一起看看吧。2017-10-10
go mod 安装依赖 unkown revision问题的解决方案
这篇文章主要介绍了go mod 安装依赖 unkown revision问题的解决方案，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-05-05
最新评论