设置页眉和页脚

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

根据给定的工作表名称和控制字符设置工作表的页眉和页脚。页眉和页脚包含如下字段:

Headers and footers are specified using the following settings fields:

字段描述
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.FormatHeaderFooter{
  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”, 第二行为日期
  • 第一页上没有页脚