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; }如果第一页使用不同的页眉或页脚，则为真。
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; }如果文档的奇数页和偶数页有不同的页眉和页脚，则为真。
Orientation { get; set; }返回或设置页面的方向。
OtherPagesTray { get; set; }获取或设置用于除部分第一页之外的所有页面的纸盘（纸盒）。 该值是特定于实现（打印机）的。
PageHeight { get; set; }返回或设置页面高度（以点为单位）。
PageNumberStyle { get; set; }获取或设置页码格式。
PageStartingNumber { get; set; }获取或设置该部分的起始页码。
PageWidth { get; set; }返回或设置页面宽度（以磅为单位）。
PaperSize { get; set; }返回或设置纸张尺寸。
RestartPageNumbering { get; set; }如果页码从节的开头重新开始，则为真。
RightMargin { get; set; }返回或设置页面右边缘和正文右边界之间的距离（以磅为单位）。
RtlGutter { get; set; }获取或设置 Microsoft Word 是否根据从右到左的语言或从左到右的语言对部分使用装订线。
SectionStart { get; set; }返回或设置指定对象的分节符类型。
SheetsPerBooklet { get; set; }返回或设置每本小册子所包含的页数。
SuppressEndnotes { get; set; }如果尾注打印在下一节的末尾，且该节不抑制尾注，则为真。 抑制的尾注将打印在该节的尾注之前。
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