WPS 基础接口 > 演示 API 参考 > HeaderFooter > HeaderFooter 对象
代表幻灯片或母版上的页眉、页脚、日期和时间、幻灯片编号或页码。幻灯片或母版的所有 HeaderFooter 对象都包含在 HeadersFooters 对象中。

说明

使用下表中列出的属性之一返回 HeaderFooter 对象。

使用此属性 返回
DateAndTime 代表幻灯片的日期和时间的 HeaderFooter 对象。
Footer 代表幻灯片页脚的 HeaderFooter 对象。
Header 代表幻灯片页眉的 HeaderFooter 对象。仅对备注页和讲义有效,不用于幻灯片。
SlideNumber 代表幻灯片编号(在幻灯片中)或页码(在备注页或讲义中)的 HeaderFooter 对象。

注释
HeaderFooter 对象对于代表备注页的 Slide 不可用。代表页眉的 HeaderFooter 对象仅对备注母版或讲义母版可用。

示例

可以为单张幻灯片设置 HeaderFooter 对象的属性。以下示例设置当前演示文稿中第一张幻灯片的页脚文本。

示例代码
ActivePresentation.Slides.Item(1).HeadersFooters.Footer.Text = "Volcano Coffee"

也可以将幻灯片母版、标题母版、备注母版或讲义母版的 HeaderFooter 对象的属性设置为同时影响所有幻灯片、标题幻灯片、备注页或讲义及大纲。以下示例设置当前演示文稿幻灯片母版的页脚文本,设置日期和时间的格式,并打开幻灯片编号的显示。这些设置将应用于两类幻灯片:所有基于该母版并显示母版图形的幻灯片,没有页脚及日期和时间的幻灯片。

示例代码
let mySlidesHF = ActivePresentation.SlideMaster.HeadersFooters
mySlidesHF.Footer.Visible = true
mySlidesHF.Footer.Text = "Regional Sales"
mySlidesHF.SlideNumber.Visible = true
mySlidesHF.DateAndTime.Visible = true
mySlidesHF.DateAndTime.UseFormat = true
mySlidesHF.DateAndTime.Format = ppDateTimeMdyy

要清除为幻灯片单独设置的页眉和页脚信息,并保证所有幻灯片显示幻灯片母版中定义的页眉和页脚信息,请在运行前面的示例前运行以下代码:

示例代码
let s = ActivePresentation.Slides
for(let i=1; i<=s.Count; i++) {
    s.Item(i).DisplayMasterShapes = true
    s.Item(i).HeadersFooters.Clear()
}


请参阅