PageSetup

PageSetup class

表示节的页面设置属性。

要了解更多信息，请访问使用部分文档文章。

public class PageSetup

特性

姓名描述
Bidi { get; set; }指定此部分包含双向（复杂脚本）文本。
BorderAlwaysInFront { get; set; }指定页面边框相对于相交文本和对象的位置。
BorderAppliesTo { get; set; }指定在哪些页面上打印页面边框。
BorderDistanceFrom { get; set; }获取或设置一个值，该值指示指定的页面边框是从页面边缘还是从其周围的文本测量。
Borders { get; }获取页面边框的集合。
BorderSurroundsFooter { get; set; }指定页面边框是包含还是排除页脚。
BorderSurroundsHeader { get; set; }指定页面边框是包含还是排除页眉。
BottomMargin { get; set; }返回或设置页面底部边缘与正文底部边界之间的距离（以磅为单位）。
ChapterPageSeparator { get; set; }获取或设置出现在章节号和页码之间的分隔符。
CharactersPerLine { get; set; }获取或设置文档网格中每行的字符数。
DifferentFirstPageHeaderFooter { get; set; }如果在第一页上使用不同的页眉或页脚，则为 True。
EndnoteOptions { get; }提供控制本节中尾注的编号和位置的选项。
FirstPageTray { get; set; }获取或设置用于某个部分的第一页的纸盘（纸箱）。 该值特定于实现（打印机）。
FooterDistance { get; set; }返回或设置页脚与页面底部之间的距离（以磅为单位）。
FootnoteOptions { get; }提供控制本节中脚注的编号和位置的选项。
Gutter { get; set; }获取或设置为文档装订添加到边距的额外空间量。
HeaderDistance { get; set; }返回或设置页眉与页面顶部之间的距离（以磅为单位）。
HeadingLevelForChapter { get; set; }获取或设置应用于文档中章节标题的标题级别样式。
LayoutMode { get; set; }获取或设置此部分的布局模式。
LeftMargin { get; set; }返回或设置页面左边缘与正文左边界之间的距离（以磅为单位）。
LineNumberCountBy { get; set; }返回或设置行号的数字增量。
LineNumberDistanceFromText { get; set; }获取或设置行号右边缘与文档左边缘之间的距离。
LineNumberRestartMode { get; set; }获取或设置行编号的运行方式，即是从新的 页或节的开头重新开始还是连续运行。
LinesPerPage { get; set; }获取或设置文档网格中每页的行数。
LineStartingNumber { get; set; }获取或设置起始行号。
Margins { get; set; }返回或设置预设Margins页面的大小.
MultiplePages { get; set; }对于多页文档，获取或设置文档的打印或呈现方式，以便将其装订为小册子。
OddAndEvenPagesHeaderFooter { get; set; }如果文档的奇数页和偶数页具有不同的页眉和页脚，则为 True。
Orientation { get; set; }返回或设置页面的方向。
OtherPagesTray { get; set; }获取或设置用于除第一页之外的所有部分的纸盘 (bin)。 该值是特定于实现（打印机）的。
PageHeight { get; set; }返回或设置页面的高度（以磅为单位）。
PageNumberStyle { get; set; }获取或设置页码格式。
PageStartingNumber { get; set; }获取或设置节的起始页码。
PageWidth { get; set; }返回或设置页面的宽度（以磅为单位）。
PaperSize { get; set; }返回或设置纸张尺寸。
RestartPageNumbering { get; set; }如果页码从节的开头重新开始，则为 True。
RightMargin { get; set; }返回或设置页面右边缘与正文右边界之间的距离（以磅为单位）。
RtlGutter { get; set; }获取或设置 Microsoft Word 是否使用基于从右到左语言或从左到右语言的节装订线。
SectionStart { get; set; }返回或设置指定对象的分节符类型。
SheetsPerBooklet { get; set; }返回或设置每本小册子中要包含的页数。
SuppressEndnotes { get; set; }如果尾注打印在下一个不抑制尾注的部分的末尾，则为 True。 抑制的尾注将在该部分中的尾注之前打印。
TextColumns { get; }返回表示文本列集的集合。
TextOrientation { get; set; }允许指定TextOrientation整个页面。 默认值为Horizontal
TopMargin { get; set; }返回或设置页面顶部边缘与正文顶部边界之间的距离（以磅为单位）。
VerticalAlignment { get; set; }返回或设置文档或节中每个页面上文本的垂直对齐方式。

方法

姓名描述
ClearFormatting()将页面设置重置为默认纸张尺寸、边距和方向。

评论

PageSetup对象包含section 的所有页面设置属性（左边距、下边距、纸张尺寸等）作为属性。

例子

演示如何将页面设置设置应用和恢复到文档中的各个部分。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 修改构建器当前部分的页面设置属性并添加文本。
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.VerticalAlignment = PageVerticalAlignment.Center;
builder.Writeln("This is the first section, which landscape oriented with vertically centered text.");

// 如果我们使用文档生成器开始一个新部分，
// 它将继承构建器的当前页面设置属性。
builder.InsertBreak(BreakType.SectionBreakNewPage);

Assert.AreEqual(Orientation.Landscape, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Center, doc.Sections[1].PageSetup.VerticalAlignment);

// 我们可以使用“ClearFormatting”方法将其页面设置属性恢复为其默认值。
builder.PageSetup.ClearFormatting();

Assert.AreEqual(Orientation.Portrait, doc.Sections[1].PageSetup.Orientation);
Assert.AreEqual(PageVerticalAlignment.Top, doc.Sections[1].PageSetup.VerticalAlignment);

builder.Writeln("This is the second section, which is in default Letter paper size, portrait orientation and top alignment.");

doc.Save(ArtifactsDir + "PageSetup.ClearFormatting.docx");

也可以看看

PageBorderDistanceFrom Enum PageVerticalAlignment Enum