word二次开发 页眉
11-25
1. 引言
在日常的WPS文字二次开发中，经常会涉及到操作页眉和页脚的情况。如：添加、删除、修改页眉和页脚中的文字、图形和图像等，
本文通过WPS文字提供的二次开发接口，以WPS为基础，同时兼顾Word来介绍其中的用法。
注意：WPS虽然与Word非常相似，但也有自身的一些特点。
2. 简介
设置页眉和页脚时，可能会涉及到与“页面设置”和“域”的知识。影响到页眉和页脚的设置如下图：
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:tempafter.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:tempafter.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:tempafter.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:tempafter.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)以上版本