设置页眉和页脚

  1. func (f *File) SetHeaderFooter(sheet string, settings *HeaderFooterOptions) error

根据给定的工作表名称和控制字符设置工作表的页眉和页脚。

页眉和页脚包含如下字段：

字段描述
AlignWithMargins设定页眉页脚边距与页边距对齐
DifferentFirst设定第一页页眉和页脚
DifferentOddEven设定奇数和偶数页页眉和页脚
ScaleWithDoc设定页眉和页脚跟随文档缩放
OddFooter奇数页页脚控制字符
OddHeader奇数页页眉控制字符
EvenFooter偶数页页脚控制字符
EvenHeader偶数页页眉控制字符
FirstFooter首页页脚控制字符
FirstHeader首页页眉控制字符

下表中的格式代码可用于 6 个字符串类型字段: OddHeader, OddFooter, EvenHeader, EvenFooter, FirstFooter, FirstHeader

格式代码描述
&&字符 “&”
&font-size文本字体的大小, 其中字体大小为以磅为单位的十进制字体大小
&”font name,font type”文本字体名字符串、字体名称和文本字体类型字符串、字体类型
&”-,Regular”常规文本格式。关闭粗体和斜体模式
&A当前工作表名称
&B or &”-,Bold”粗体文本格式, 关闭或打开，默认关闭。
&D当前日期
&C中间部分
&E对文本使用双下划线
&F当前工作簿文件名称
&G将指定对象做为背景（暂不支持）
&H文字阴影
&I or &”-,Italic”文字倾斜
&K字体颜色
格式为 RRGGBB 的 RGB 颜色
主题颜色被指定为 TTSNNN, 其中 TT 是主题颜色 id, S 是色调或阴影的 “+” 或者 “-“, 是色调或阴影的值
&L左侧部分
&N总页数
&O大纲文本格式
&P[[+|-]n]如果没有可选的后缀, 当前页码 (十进制)
&R右侧部分
&S文本删除线
&T当前时间
&U为文本添加单下划线。默认模式处于关闭状态
&X上标格式
&Y下标格式
&Z当前工作簿文件路径

例如：

  1. err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
  2.     DifferentFirst:   true,
  3.     DifferentOddEven: true,
  4.     OddHeader:        "&R&P",
  5.     OddFooter:        "&C&F",
  6.     EvenHeader:       "&L&P",
  7.     EvenFooter:       "&L&D&R&T",
  8.     FirstHeader:      `&CCenter &"-,Bold"Bold&"-,Regular"HeaderU+000A&D`,
  9. })

上面的例子蕴含如下格式：

  • 第一页有自己的页眉和页脚
  • 奇数和偶数页具有不同的页眉和页脚
  • 奇数页标题右侧部分为当前页码
  • 奇数页页脚中心部分为当前工作簿的文件名
  • 偶数页标题左侧部分为当前页码
  • 左侧部分为当前日期，偶数页页脚右侧部分为当前时间
  • 第一页中心部分的第一行上的文本为“Center Bold Header”, 第二行为日期
  • 第一页上没有页脚