ClearHeadersFooters

ClearHeadersFooters()

清除此部分的页眉和页脚。

public void ClearHeadersFooters()

评论

所有页眉和页脚的文本均被清除,但HeaderFooter对象本身不会被移除。

这使得本节的页眉和页脚链接到上一节的页眉和页脚。

例子

展示如何清除某一部分中所有页眉和页脚的内容。

Document doc = new Document();

Assert.AreEqual(0, doc.FirstSection.HeadersFooters.Count);

DocumentBuilder builder = new DocumentBuilder(doc);

builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.Writeln("This is the primary header.");
builder.MoveToHeaderFooter(HeaderFooterType.FooterPrimary);
builder.Writeln("This is the primary footer.");

Assert.AreEqual(2, doc.FirstSection.HeadersFooters.Count);

Assert.AreEqual("This is the primary header.", doc.FirstSection.HeadersFooters[HeaderFooterType.HeaderPrimary].GetText().Trim());
Assert.AreEqual("This is the primary footer.", doc.FirstSection.HeadersFooters[HeaderFooterType.FooterPrimary].GetText().Trim());

// 清空此部分中所有页眉和页脚的所有内容。
// 页眉和页脚本身仍会存在,但不会显示任何内容。
doc.FirstSection.ClearHeadersFooters();

Assert.AreEqual(2, doc.FirstSection.HeadersFooters.Count);

Assert.AreEqual(string.Empty, doc.FirstSection.HeadersFooters[HeaderFooterType.HeaderPrimary].GetText().Trim());
Assert.AreEqual(string.Empty, doc.FirstSection.HeadersFooters[HeaderFooterType.FooterPrimary].GetText().Trim());

也可以看看


ClearHeadersFooters(bool)

清除此部分的页眉和页脚。

public void ClearHeadersFooters(bool preserveWatermarks)
范围类型描述
preserveWatermarksBoolean如果水印不能被去除,则为真。

评论

所有页眉和页脚的文本均被清除,但HeaderFooter对象本身不会被移除。

这使得本节的页眉和页脚链接到上一节的页眉和页脚。

例子

展示如何清除带有或不带有水印的页眉和页脚的内容。

Document doc = new Document(MyDir + "Header and footer types.docx");

// 添加纯文本水印。
doc.Watermark.SetText("Aspose Watermark");

// 确保页眉和页脚有内容。
HeaderFooterCollection headersFooters = doc.FirstSection.HeadersFooters;
Assert.AreEqual("First header", headersFooters[HeaderFooterType.HeaderFirst].GetText().Trim());
Assert.AreEqual("Second header", headersFooters[HeaderFooterType.HeaderEven].GetText().Trim());
Assert.AreEqual("Third header", headersFooters[HeaderFooterType.HeaderPrimary].GetText().Trim());
Assert.AreEqual("First footer", headersFooters[HeaderFooterType.FooterFirst].GetText().Trim());
Assert.AreEqual("Second footer", headersFooters[HeaderFooterType.FooterEven].GetText().Trim());
Assert.AreEqual("Third footer", headersFooters[HeaderFooterType.FooterPrimary].GetText().Trim());

// 删除除水印之外的所有页眉和页脚内容。
doc.FirstSection.ClearHeadersFooters(true);

headersFooters = doc.FirstSection.HeadersFooters;
Assert.AreEqual("", headersFooters[HeaderFooterType.HeaderFirst].GetText().Trim());
Assert.AreEqual("", headersFooters[HeaderFooterType.HeaderEven].GetText().Trim());
Assert.AreEqual("", headersFooters[HeaderFooterType.HeaderPrimary].GetText().Trim());
Assert.AreEqual("", headersFooters[HeaderFooterType.FooterFirst].GetText().Trim());
Assert.AreEqual("", headersFooters[HeaderFooterType.FooterEven].GetText().Trim());
Assert.AreEqual("", headersFooters[HeaderFooterType.FooterPrimary].GetText().Trim());
Assert.AreEqual(WatermarkType.Text, doc.Watermark.Type);

// 删除所有页眉和页脚内容,包括水印。
doc.FirstSection.ClearHeadersFooters(false);
Assert.AreEqual(WatermarkType.None, doc.Watermark.Type);

也可以看看