PageSetup 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

页面设置设置。

此类在 Office 2007 及更高版本中可用。

将对象序列化为 xml 时，其限定名称为 x：pageSetup。

public class PageSetup : DocumentFormat.OpenXml.OpenXmlLeafElement

type PageSetup = class
    inherit OpenXmlLeafElement

Public Class PageSetup
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

PageSetup

注解

[ISO/IEC 29500-1 第 1 版]

pageSetup (Page Setup Settings)

工作表的页面设置设置。

[示例：以下示例显示了 A0 纸张的 pageSetup 元素（以黑白两色打印），并带有图形：

<pageSetup blackAndWhite="true" draft="false" paperHeight="1189" paperWidth="841" paperUnits="mm" />  

示例结束]

父元素
customSheetView (§18.3.1.25) ;dialogsheet (§18.3.1.34) ;worksheet (§18.3.1.99)

属性	说明
blackAndWhite (黑白)	打印黑白。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
cellComments (打印单元格注释)	此属性指定如何打印单元格注释。 此属性的可能值由 ST_CellComments 简单类型 (§18.18.5) 定义。
副本 (副本数)	要打印的副本数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
草稿 (草稿)	打印时不带图形。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
错误 (打印错误处理)	指定如何打印有错误的单元格的单元格值。 此属性的可能值由 ST_PrintError 简单类型 (§18.18.60) 定义。
firstPageNumber (First Page Number)	第一个打印页的页码。 如果未指定任何值，则假定为“automatic”。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
fitToHeight (适应高度)	要容纳的垂直页数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
fitToWidth (适应宽度)	要容纳的水平页数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
horizontalDpi (水平 DPI)	设备的水平打印分辨率。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
id (Id) 命名空间： .../officeDocument/2006/relationships	devMode 打印机设置部分的关系 ID。 此属性的可能值由 ST_RelationshipId 简单类型 (§22.8.2.1) 定义。
orientation (Orientation)	页面的方向。 此属性的可能值由 ST_Orientation 简单类型 (§18.18.50) 定义。
pageOrder (Page Order)	打印页面的顺序。 此属性的可能值由 ST_PageOrder 简单类型 (§18.18.51) 定义。
paperHeight (纸张高度)	自定义纸张的高度作为数字，后跟单位标识符。 [示例：297mm，11英寸结束示例] 指定 paperHeight 和 paperWidth 时，应忽略 paperSize。 此属性的可能值由 ST_PositiveUniversalMeasure 简单类型 (§22.9.2.12) 定义。
paperSize (纸张大小)	纸张大小 1 = 信纸 (8.5 in。by 11 in.) 2 = 字母小纸 (8.5 in。by 11 in.) 3 = 小报纸 (11 in。by 17 in.) 4 = 账本纸 (17 in。by 11 in.) 5 = 法律论文 (8.5 in。by 14 in.) 6 = 声明纸 (5.5 in。by 8.5 in.) 7 = 执行论文 (7.25 in。by 10.5 in.) 8 = A3 纸张 (297 毫米 x 420 毫米) 9 = A4 纸张 (210 毫米 x 297 毫米) 10 = A4 小纸 (210 毫米 x 297 毫米) 11 = A5 纸张 (148 毫米 x 210 毫米) 12 = B4 纸张 (250 毫米 x 353 毫米) 13 = B5 纸张 (176 毫米 x 250 毫米) 14 = Folio 纸张 (8.5 in。by 13 in.) 15 = Quarto 纸张 (215 毫米 x 275 毫米) 16 = 标准纸张 (10 in。by 14 in.) 17 = 标准纸张 (11 in。by 17 in.) 18 = 记事本 (8.5 in。by 11 in.) 19 = #9 信封 (3.875 in。by 8.875 in.) 20 = #10 信封 (4.125 in.by 9.5 in.) 21 = #11 信封 (4.5 in。by 10.375 in.) 22 = #12 信封 (4.75 in。by 11 in.) 23 = #14 信封 (5 in.by 11.5 in.) 24 = C 纸 (17 in。by 22 in.) 25 = D 纸 (22 in。by 34 in.) 26 = E 纸 (34 in。by 44 in.) 27 = DL 信封 (110 毫米 x 220 毫米) 28 = C5 信封 (162 毫米 x 229 毫米) 29 = C3 信封 (324 毫米 x 458 毫米) 30 = C4 信封 (229 mm x 324 mm) 31 = C6 信封 (114 毫米 x 162 毫米) 32 = C65 信封 (114 毫米 x 229 毫米) 33 = B4 信封 (250 毫米 x 353 毫米) 34 = B5 信封 (176 毫米 x 250 毫米) 35 = B6 信封 (176 毫米 x 125 毫米) 36 = 意大利信封 (110 毫米 x 230 毫米) 37 = 君主信封 (3.875 in.by 7.5 in.) . 38 = 6 3/4 信封 (3.625 in。by 6.5 in.) 39 = 美国标准风扇 (14.875 in。by 11 in.) 40 = 德国标准扇 (8.5 in。by 12 in.) 41 = 德国法律粉丝 (8.5 in.by 13 in.) 42 = B4 (250 mm x 353 mm) 43 = 日本双明信片 (200 毫米 x 148 毫米) 44 = 标准纸张 (9 in。by 11 in.) 45 = 标准纸张 (10 in。by 11 in.) 46 = 标准纸张 (15 in。by 11 in.) 47 = 邀请信封 (220 毫米 x 220 毫米) 50 = 信函额外纸张 (9.275 in。by 12 in.) 51 = 法律额外纸张 (9.275 in.by 15 in.) 52 = 小报额外纸张 (11.69 in.by 18 in.) 53 = A4 额外纸张 (236 毫米 x 322 毫米) 54 = 字母横向纸张 (8.275 in。by 11 in.) 55 = A4 横向纸张 (210 毫米 x 297 毫米) 56 = 字母额外横向纸张 (9.275 in。by 12 in.) 57 = SuperA/SuperA/A4 纸张 (227 毫米 x 356 毫米) 58 = SuperB/SuperB/A3 纸张 (305 毫米 x 487 毫米) 59 = 字母加纸 (8.5 in。由 12.69 in.) 60 = A4 加纸张 (210 毫米 x 330 毫米) 61 = A5 横向纸张 (148 毫米 x 210 毫米) 62 = JIS B5 横向纸张 (182 毫米 x 257 毫米) 63 = A3 额外纸张 (322 毫米 x 445 毫米) 64 = A5 额外纸张 (174 毫米 x 235 毫米) 65 = B5 额外纸张 (201 毫米 x 276 毫米) 66 = A2 纸张 (420 毫米 x 594 毫米) 67 = A3 横向纸张 (297 毫米 x 420 毫米) 68 = A3 额外的横向纸张 (322 毫米 x 445 毫米) 指定 paperHeight、paperWidth 和 paperUnits 时，应忽略 paperSize。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
paperWidth (纸张宽度)	自定义纸张的宽度为数字，后跟单位标识符。 [示例：21cm，8.5inend example] 指定 paperHeight 和 paperWidth 时，应忽略 paperSize。 此属性的可能值由 ST_PositiveUniversalMeasure 简单类型 (§22.9.2.12) 定义。
scale (Print Scale)	打印缩放。 此属性限制为范围从 10 到 400 的值。 [示例： 10 - 10% 20 - 20% … 100 - 100% … 400 - 400% 示例结束] 使用 fitToWidth 和/或 fitToHeight 时，将重写此设置。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
useFirstPageNumber (使用首页编号)	对首页页码使用 firstPageNumber 值，并且不要自动为页面编号。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
usePrinterDefaults (使用打印机默认值)	对页面设置值使用打印机的默认设置，不要使用架构中指定的默认值。 [示例：如果 XML 中不存在或未指定 dpi，则应用程序不得假定架构中指定的 600dpi 为默认值，而必须让打印机指定默认 dpi。 示例结束] 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
verticalDpi (Vertical DPI)	设备的垂直打印分辨率。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。

[注意：此元素的内容模型 (CT_PageSetup) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

PageSetup()

初始化 PageSetup 类的新实例。

属性

BlackAndWhite	黑白 表示架构中的以下属性：blackAndWhite
CellComments	打印单元格注释 表示架构中的以下属性：cellComments
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Copies	副本数 表示架构中的以下属性：副本
Draft	Draft 表示架构中的以下属性：draft
Errors	打印错误处理 表示架构中的以下属性：errors
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
FirstPageNumber	首页编号 表示架构中的以下属性：firstPageNumber
FitToHeight	适合高度 表示架构中的以下属性：fitToHeight
FitToWidth	适应宽度 表示架构中的以下属性：fitToWidth
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
HorizontalDpi	水平 DPI 表示架构中的以下属性：horizontalDpi
Id	Id 表示架构中的以下属性：r：id
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
Orientation	Orientation 表示架构中的以下属性：orientation
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
PageOrder	页面顺序 表示架构中的以下属性：pageOrder
PaperSize	纸张大小 表示架构中的以下属性：paperSize
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Scale	打印比例 表示架构中的以下属性：scale
UseFirstPageNumber	使用首页编号 表示架构中的以下属性：useFirstPageNumber
UsePrinterDefaults	使用打印机默认值 表示架构中的以下属性：usePrinterDefaults
VerticalDpi	垂直 DPI 表示架构中的以下属性：verticalDpi
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素列表中指定索引处插入指定的元素。 (继承自 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlLeafElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	从当前元素的子元素列表中删除指定的子元素。 (继承自 OpenXmlElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将子元素替换为当前元素的子元素列表中的另一个子元素。 (继承自 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

IEnumerable.GetEnumerator()	页面设置设置。 此类在 Office 2007 及更高版本中可用。 将对象序列化为 xml 时，其限定名称为 x：pageSetup。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)