在日常的WPS文字二次开发中，经常会涉及到操作页眉和页脚的情况。如：添加、删除、修改页眉和页脚中的文字、图形和图像等，

本文通过WPS文字提供的二次开发接口，以WPS为基础，同时兼顾Word来介绍其中的用法。

注意：WPS虽然与Word非常相似，但也有自身的一些特点。

简介

设置页眉和页脚时，可能会涉及到与“页面设置”和“域”的知识。影响到页眉和页脚的设置如下图：

2.1. 节、页面设置、页码域

节：通常以为文档的下一个对象是节(即Application->Documents->Sections)，页眉和页脚可以在不同的节中进行不同的设置。

页面设置：

奇偶页不同：此功能为方便设置类似于书籍的“页眉和页脚”，如字典。

首页不同：此功能为方便设置首页为封面而设置。(注：通常封面不显示页码)

域：如果在页眉和页脚中插入了页码域(即，如果你做了如下的操作：插入、页码，这样插入的页码就是一个域，与，在输入page是一样的域)，则每页的页码会根据当前所在页而改变。

2.2. 读取页眉和页脚的内容

下面以页眉来介绍，页脚只要将Headers改为Footers即可，其他知识完全一样。

通常的方法是：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Range.Text

注：这里的wpsHeaderFooterPrimary可以取得枚举值及描述如下：

名称 值 描述

wpsHeaderFooterEvenPages 3 返回偶数页上的所有页眉或页脚

wpsHeaderFooterFirstPage 2 返回文档或节中的第一个页眉或页脚

wpsHeaderFooterPrimary 1 返回文档或节中除第一页外所有页上的页眉或页脚

针对“页面设置”的不同，所以，对读取页眉中的内容细分如下：

2.2.1. 在页面设置中勾选了“奇偶页不同”

读取偶数页的内容：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterEvenPages).Range.Text

读取奇数页的内容：

可以使用：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Range.Text

注意：

如果页眉中设置了动态的内容，如第*页(“*”代表是一个根据页码自动更新的数字)，则读出的内容：

这里与Word的差异：

1. Word：是根据当前光标的位置而定(如：光标放在第2页，则wdHeaderFooterEvenPages读出的是第2页的页眉内容，如果在第4页，则读出的是第4页的内容，如果光标在第3页，则读出什么有时是2页，有时是4页，规律不细说)。

2. WPS：读取的就是第一个匹配的页眉(如：wpsHeaderFooterEvenPages读的就是第2页的内容;wpsHeaderFooterPrimary则是第1页或者第3页的内容)。

2.2.2. 在页面设置中勾选了“首页不同”

读取第一页的内容：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterFirstPage).Range.Text

读取除第一页的内容：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Range.Text

2.3. 删除、修改页眉的内容

与上面同理，通常用(其他情况，请参考上面的方法)：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Range.Text="KingSoft"

3. 操作页眉中的图形或图像

3.1. 读取页眉中的图形或图像

读取页眉与页脚中的所有图形(不包含嵌入式图片)：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Shapes.Count

也可以用：wpsHeaderFooterFirstPage、wpsHeaderFooterEvenPages此处三个读出的结果完全相同。

读取在页面设置中勾选了“首页不同”中的页眉中的图形(不包含嵌入式图片)：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterFirstPage).Range.ShapeRange.Count

其他的偶数页等与其类似。

注意：

大多数情况应该使用.Range.ShapeRange.Count来操作图形。

3.2. 添加一个图形到页眉中且左对齐

注意：

以下代码仅供演示使用，不对可能存在的任何问题负任何责任。

要运行以下代码，必须满足两个文件：

1. 假设有C:\temp\after.gif文件;

2. 已经可以切换到页眉与页脚中一次，即已有页眉与页脚信息，即至少有一个回车符，如下图(Word不需要这个条件)。

示例代码1：'添加图片到页眉中的且左对齐

Sub AddPicturetoHeaderToLeft()

Dim myleft, mytop

myleft = ActiveDocument.Sections(1).PageSetup.LeftMargin

mytop = ActiveDocument.Sections(1).PageSetup.HeaderDistance

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Shapes.Addpicture _

"C:\temp\after.gif", Left:=myleft, Top:=mytop

End Sub

示例代码2：'添加图片到页眉中的且右对齐

Sub AddPicturetoHeaderToRight()

Dim myleft, mytop

Dim tempshape As Shape

mytop = ActiveDocument.Sections(1).PageSetup.HeaderDistance

myleft = ActiveDocument.Sections(1).PageSetup.PageWidth - ActiveDocument.Sections(1).PageSetup.RightMargin

Set tempshape = ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Shapes.Addpicture _

("C:\temp\after.gif", Left:=myleft, Top:=mytop)

tempshape.Left = tempshape.Left - tempshape.Width

End Sub

示例代码3：'添加图片到页眉中的且右对齐

Sub AddPicturetoFooterToLeft()

Dim myleft, mytop

myleft = ActiveDocument.Sections(1).PageSetup.LeftMargin

mytop = ActiveDocument.Sections(1).PageSetup.PageHeight - ActiveDocument.Sections(1).PageSetup.BottomMargin

mytop = mytop + (ActiveDocument.Sections(1).PageSetup.BottomMargin - ActiveDocument.Sections(1).PageSetup.FooterDistance)

mytop = mytop - 11

ActiveDocument.Sections(1).Footers(wpsHeaderFooterPrimary).Shapes.Addpicture _

"C:\temp\after.gif", Left:=myleft, Top:=mytop

End Sub

4. 注意事项

1. 如果通过“插入”、“页码”的形式插入了一个页码，则从“视图”、“页眉和页脚”进入视图时，光标默认会在页码的图文框中，这个可能会影响到用户通过API切换视图来编辑页眉与页脚的情况。

2. 页眉与页脚(包括正文)中插入图形时，ShapeRange的顺序与Shapes的顺序是不一样的。

通常应该使用Shapes来取最后一个插入的图形：

ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Shapes(ActiveDocument.Sections(1).Headers(wpsHeaderFooterPrimary).Shapes.Count).Select

5. 参考

更多的API操作，请参阅 WPS API 帮助文档。

6. 适用范围

适用于 WPS Office 2009(1705)以上版本