Settings 类

定义

命名空间:

DocumentFormat.OpenXml.Wordprocessing

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

文档设置。

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

当对象序列化为 xml 时，其限定名称为 w：settings。

public class Settings : DocumentFormat.OpenXml.OpenXmlPartRootElement

type Settings = class
    inherit OpenXmlPartRootElement

Public Class Settings
Inherits OpenXmlPartRootElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

OpenXmlPartRootElement

Settings

注解

[ISO/IEC 29500-1 第 1 版]

设置 (文档设置)

此元素指定应用于 WordprocessingML 文档的设置。 此元素是 WordprocessingML 文档中文档设置部分的根元素。

[示例：请考虑文档的设置部分的以下 WordprocessingML 片段：

<w:settings>  
  <w:defaultTabStop w:val="720" />  
  <w:characterSpacingControl w:val="doNotCompress" />  
</w:settings>  

settings 元素包含此文档的所有设置。 在这种情况下，应用的两个设置是使用 defaultTabStop 元素自动制表位增量 0.5 英寸，不使用 characterSpacingControl 元素进行字符级空格压缩。 示例结束]

父元素
WordprocessingML 文档设置部分的根元素

子元素	第
activeWritingStyle (语法检查设置)	§17.15.1.1
alignBordersAndEdges (使用页面边框对齐段落和表格边框)	§17.15.1.2
alwaysMergeEmptyNamespace (不将没有命名空间的自定义 XML 元素标记为无效)	§17.15.1.3
alwaysShowPlaceholderText (使用自定义 XML 元素名称作为默认占位符文本)	§17.15.1.4
attachedSchema (附加的自定义 XML 架构)	§17.15.1.5
attachedTemplate (附加文档模板)	§17.15.1.6
autoFormatOverride (允许自动格式化以覆盖格式保护设置)	§17.15.1.9
autoHyphenation (在显示文档内容时自动断字符)	§17.15.1.10
bookFoldPrinting (Book Fold Printing)	§17.15.1.11
bookFoldPrintingSheets (每本小册子的页数)	§17.15.1.12
bookFoldRevPrinting (反向书籍折叠打印)	§17.15.1.13
bordersDoNotSurroundFooter (Page Border 排除页脚)	§17.15.1.14
bordersDoNotSurroundHeader (Page Border Excludes Header)	§17.15.1.15
captions (Caption Settings)	§17.15.1.17
characterSpacingControl (字符级空格压缩)	§17.15.1.18
clickAndTypeStyle (段落样式应用于自动生成的段落)	§17.15.1.19
clrSchemeMapping (主题颜色映射)	§17.15.1.20
兼容性设置 ()	§17.15.1.21
consecutiveHyphenLimit (连续断字符行的最大数目)	§17.15.1.22
decimalSymbol (用于字段代码评估) 的基数点	§17.15.1.23
defaultTableStyle (新插入表的默认表样式)	§17.15.1.24
defaultTabStop (自动制表位之间的距离)	§17.15.1.25
displayBackgroundShape (在显示文档) 时显示背景对象	§17.15.1.26
displayHorizontalDrawingGridEvery (水平网格线之间的距离)	§17.15.1.27
displayVerticalDrawingGridEvery (垂直网格线之间的距离)	§17.15.1.28
documentProtection (文档编辑限制)	§17.15.1.29
documentType (文档分类)	§17.15.1.30
docVars (Document Variables)	§17.15.1.32
doNotAutoCompressPictures (请勿自动压缩图像)	§17.15.1.33
doNotDemarcateInvalidXml (不显示无效自定义 XML 标记的视觉指示器)	§17.15.1.34
doNotDisplayPageBoundaries (不显示页眉/页脚的可视边界或页面之间的)	§17.15.1.35
保存) 时 doNotEmbedSmartTags (删除智能标记	§17.15.1.36
doNotHyphenateCaps (不要在所有大写字母中断字)	§17.15.1.37
doNotIncludeSubdocsInStats (在文档统计信息中不包括文本框、脚注和尾注中的内容)	§17.15.1.38
doNotShadeFormData (不显示窗体字段的视觉指示器)	§17.15.1.39
doNotTrackFormatting (跟踪修订时不跟踪格式修订)	§17.15.1.40
doNotTrackMoves (跟踪修订时不使用移动语法)	§17.15.1.41
doNotUseMarginsForDrawingGridOrigin (请勿使用边距绘制网格原点)	§17.15.1.42
doNotValidateAgainstSchema (不要根据架构验证自定义 XML 标记)	§17.15.1.43
drawingGridHorizontalOrigin (绘制网格水平原点)	§17.15.1.44
drawingGridHorizontalSpacing (绘图网格水平网格单位大小)	§17.15.1.45
drawingGridVerticalOrigin (绘图网格垂直原点)	§17.15.1.46
drawingGridVerticalSpacing (绘图网格垂直网格单位大小)	§17.15.1.47
embedSystemFonts (嵌入通用系统字体)	§17.8.3.7
embedTrueTypeFonts (嵌入 TrueType 字体)	§17.8.3.8
endnotePr (文档范围的尾注属性)	§17.11.4
evenAndOddHeaders (不同的偶数/奇数页页眉和页脚)	§17.10.1
footnotePr (文档范围脚注属性)	§17.11.12
打开) 上的 forceUpgrade (升级文档	§17.15.1.48
formsDesign (结构化文档标记占位符文本应重新保存)	§17.15.1.49
gutterAtTop (将 Gutter 定位在页面顶部)	§17.15.1.50
hideGrammaticalErrors (不显示语法错误的视觉指示)	§17.15.1.51
hideSpellingErrors (不显示拼写错误的视觉指示)	§17.15.1.52
hyphenationZone (断字区域)	§17.15.1.53
在验证自定义 XML 标记) 时，ignoreMixedContent (忽略混合内容	§17.15.1.54
linkStyles (从文档模板) 自动更新样式	§17.15.1.55
listSeparator (字段代码评估) 的列表分隔符	§17.15.1.56
mailMerge (邮件合并设置)	§17.14.20
mathPr (数学属性)	§22.1.2.62
mirrorMargins (Mirror 页边距)	§17.15.1.57
noLineBreaksAfter (无法结束行) 的自定义字符集	§17.15.1.58
noLineBreaksBefore (无法开始行) 的自定义字符集	§17.15.1.59
noPunctuationKerning (Never Kern 标点符号字符)	§17.15.1.60
printFormsData (仅打印窗体字段内容)	§17.15.1.61
printFractionalCharacterWidth (打印小数字符宽度)	§17.15.1.62
printPostScriptOverText (打印带有文档文本) 的 PostScript 代码	§17.15.1.63
printTwoOnOne (每页打印两页)	§17.15.1.64
proofState (拼写和语法检查状态)	§17.15.1.65
readModeInkLockDown (冻结文档布局)	§17.15.1.66
removeDateAndTime (从批注中删除日期和时间)	§17.15.1.67
removePersonalInformation (从文档属性中删除个人信息)	§17.15.1.68
revisionView (注释类型的可见性)	§17.15.1.69
rsids (列出所有修订保存 ID 值)	§17.15.1.72
saveFormsData (仅保存窗体字段内容)	§17.15.1.73
saveInvalidXml (在自定义 XML 标记无效时允许将文档另存为 XML 文件)	§17.15.1.74
savePreviewPicture (在保存) 时为文档生成缩略图	§17.15.1.75
saveSubsetFonts (嵌入) 时子集字体	§17.8.3.15
saveThroughXslt (另存为 XML 文件时要使用的自定义 XSL 转换)	§17.15.1.76
saveXmlDataOnly 仅 (保存自定义 XML 标记)	§17.15.1.77
schemaLibrary (嵌入式自定义 XML 架构补充数据)	§23.2.2
showEnvelope (显示电子邮件头)	§17.15.1.79
showXMLTags (显示自定义 XML 标记的视觉指示器开始/结束位置)	§17.15.1.80
smartTagType (补充智能标记信息)	§17.15.1.81
strictFirstAndLastChars (对日语文本使用严格的 Kinsoku 规则)	§17.15.1.82
styleLockQFSet (防止替换样式部件)	§17.15.1.83
styleLockTheme (防止修改主题第) 部分	§17.15.1.84
stylePaneFormatFilter (文档样式列表的建议筛选)	§17.15.1.85
stylePaneSortMethod (文档样式列表的建议排序)	§17.15.1.86
summaryLength (生成摘要) 时要使用的文档百分比	§17.15.1.87
themeFontLang (主题字体语言)	§17.15.1.88
trackRevisions (跟踪文档) 的修订	§17.15.1.89
updateFields (打开) 时自动重新计算字段	§17.15.1.90
useXSLTWhenSaving (通过自定义 XSL 转换将文档另存为 XML 文件)	§17.15.1.91
视图 (文档视图设置)	§17.15.1.92
writeProtection (Write Protection)	§17.15.1.93
缩放 (放大缩小字体功能 放大缩小字体) 功能 放大缩小字体功能	§17.15.1.94

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

ISO/IEC29500：2008。

构造函数

Settings()	初始化 Settings 类的新实例。
Settings(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 Settings 类的新实例。
Settings(OpenXmlElement[])	使用指定的子元素初始化 Settings 类的新实例。
Settings(String)	从外部 XML 初始化 Settings 类的新实例。

属性

AlignBorderAndEdges	将段落边框和表格边框与页面边框对齐。 表示架构中的以下元素标记：w：alignBordersAndEdges。
BordersDoNotSurroundFooter	页面边框排除页脚。 表示架构中的以下元素标记：w：bordersDoNotSurroundFooter。
BordersDoNotSurroundHeader	页面边框排除页眉。 表示架构中的以下元素标记：w：bordersDoNotSurroundHeader。
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
DisplayBackgroundShape	显示文档时显示背景对象。 表示架构中的以下元素标记：w：displayBackgroundShape。
DocumentSettingsPart	获取与此元素关联的 DocumentSettingsPart。
DoNotDisplayPageBoundaries	不要显示页眉/页脚或页之间的视觉边界。 表示架构中的以下元素标记：w：doNotDisplayPageBoundaries。
EmbedSystemFonts	嵌入通用系统字体。 表示架构中的以下元素标记：w：embedSystemFonts。
EmbedTrueTypeFonts	嵌入 TrueType 字体。 表示架构中的以下元素标记：w：embedTrueTypeFonts。
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
GutterAtTop	将 Gutter 置于页面顶部。 表示架构中的以下元素标记：w：gutterAtTop。
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
HideGrammaticalErrors	不显示语法错误的视觉指示。 表示架构中的以下元素标记：w：hideGrammaticalErrors。
HideSpellingErrors	不显示拼写错误的视觉指示。 表示架构中的以下元素标记：w：hideSpellingErrors。
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
MirrorMargins	镜像页边距。 表示架构中的以下元素标记：w：mirrorMargins。
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OpenXmlPart	获取与 DOM 树关联的部分。 当 DOM 树未与部件关联时，它返回 null。 (继承自 OpenXmlPartRootElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
PrintFormsData	仅打印窗体字段内容。 表示架构中的以下元素标记：w：printFormsData。
PrintFractionalCharacterWidth	打印小数字符宽度。 表示架构中的以下元素标记：w：printFractionalCharacterWidth。
PrintPostScriptOverText	使用文档文本打印 PostScript 代码。 表示架构中的以下元素标记：w：printPostScriptOverText。
RemoveDateAndTime	从批注中删除日期和时间。 表示架构中的以下元素标记：w：removeDateAndTime。
RemovePersonalInformation	从文档属性中删除个人信息。 表示架构中的以下元素标记：w：removePersonalInformation。
SaveFormsData	仅保存窗体字段内容。 表示架构中的以下元素标记：w：saveFormsData。
SaveSubsetFonts	嵌入时的子集字体。 表示架构中的以下元素标记：w：saveSubsetFonts。
View	文档视图设置。 表示架构中的以下元素标记：w：view。
WriteProtection	写入保护。 表示架构中的以下元素标记：w：writeProtection。
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
Zoom	放大设置。 表示架构中的以下元素标记：w：zoom。

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
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)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
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)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
Load(DocumentSettingsPart)	从 DocumentSettingsPart 加载 DOM
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)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Reload()	将部件内容重新加载到 Open XML DOM 树中。 此方法可以多次调用，每次调用它时，都会重新加载树，并放弃树上的先前更改。 (继承自 OpenXmlPartRootElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
Save()	将 DOM 树中的数据保存回 部件。 此方法可以多次调用，每次调用时，都会刷新流。 (继承自 OpenXmlPartRootElement)
Save(DocumentSettingsPart)	将 DOM 保存到 DocumentSettingsPart 中。
Save(Stream)	将 DOM 树保存到指定的流。 (继承自 OpenXmlPartRootElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlPartRootElement)

显式接口实现

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