PS:哪里有翻译不好的地方请留言，翻译到后面的时候时间比较紧张，因此采用的是机器翻译，后面也没有仔细查阅，另外本人英语也不算多好，所以还请大家指正。
Styles对象也是可以迭代的，通过使用BaseStyle上的标识属性，可以生成定义样式的各种子集。例如，这段代码将生成一个定义的段落样式列表:
Paragraph、Run和Table对象每个都有Styles属性，为这些属性分配一个样式对象将应用该样式:
样式名也可以直接指定，在这种情况下，python-docx将为您执行查找
样式还可以在创建时使用样式对象或其名称:
一个新样式可以通过指定一个唯一的名字和类型来添加到文档中：
使用base_style属性指定新样式应该从以下位置继承格式设置:
一个样式可以通过使用一个简单的delete()方法来删除：
|
|
从文档中删除Style.delete()方法。它不会影响应用该样式的文档中的内容。具有文档中未定义的样式的内容是使用该内容对象的默认样式呈现的，例如段落中的“Normal”
|
字符、段落和表样式都可以指定要应用于具有该样式的内容的字符格式。可以直接应用于文本的所有字符格式都可以用样式指定。示例包括字体字体和大小、粗体、斜体和下划线。
这三种样式类型中的每一种都有一个font属性，提供对Font对象的访问。样式的字体对象提供了获取和设置该样式的字符格式的属性。
这里提供了几个例子，要想了解更详细的信息，请参阅：Font API参考手册。
Font样式可以通过这样访问：
字体和字号可以通过这样访问：
许多字体属性都是三态的，意味着，意味着他们可以有：True,False和None。True意味着属性是“打开”，False意味着“关闭”，从概念上说，None意味着“继承”。因为样式存在于继承层次结构中，所以有能力在层次结构中的正确位置指定属性是很重要的，通常是在层次结构中越高越好。例如，如果所有标题都应该使用Arial字体，那么在标题1样式上设置这个属性，让标题2从标题1继承就更有意义了。
粗体和斜体是三态属性，全大写、删除线、上标等等也是三态属性。有关完整列表，请参阅FontAPI文档:
下划线是一种特殊的情况，它是三态属性和枚举值属性的混合。True表示单下划线，这是目前最常见的。False表示不需要下划线，但如果不需要下划线，通常都不是正确的选择，因为很少从基本样式继承下划线。其他形式的下划线，如双划线或虚线，都是由WD_UNDERLINE枚举成员指定的:
段落样式和表格样式都允许指定段落格式。这些样式都提供了对ParagraphFormat对象的paragraph_format属性的访问方法。
段落格式包括布局，如对齐、缩进、前后空格、前分页和孤行控制。有关可用属性的完整列表，请参阅ParagraphFormat的API文档。
这是一个例子，告诉你如何创建一个段落样式，悬挂缩进1/4字符，12pint的间距，和孤行控制:
使用特定段落的样式属性
段落样式具有next_paragraph_style属性，该属性指定将应用于在该样式的段落之后插入的新段落的样式。当样式通常只在序列中出现一次(如标题)时，这是非常有用的。在这种情况下，段落样式可以在完成标题后自动恢复为主体样式。
在大多数的情况下(正文段落)，后续段落应采用与当前段落相同的风格。如果没有指定下一段的样式，默认的样式可以通过应用相同的样式很好地处理这种情况。
这里是一个如果在一个主体文本里改变下一段标题1样式的的例子：
这种默认可以通过设置其为None或样式本身来恢复:
控制在Word的UI中样式如何显示？
样式的属性分为两类，行为属性和格式属性。它的行为属性控制样式在UI中出现的时间和位置。它的格式属性决定了应用样式的内容的格式，比如字体的大小和段落缩进。
这是5中样式的行为属性；
有关这些行为属性如何交互的描述，请参阅“”中的“”部分，以确定样式在UI中出现的时间和位置。
优先级属性接受一个整数值。其他四个样式行为属性是三态属性，这意味着它们可以取值True(打开)、False(关闭)或None(继承)。
在样式库中显示一个样式
以下代码将使“正文文本”段落样式首先出现在样式库中:
在样式库中移除一个样式
他的代码将从样式库中删除“普通”段落样式，但允许它保留在推荐列表中:
请参阅“”中的“”和“”部分，以了解隐式样式如何定义尚未在样式中定义的内建样式的行为属性在python.docx文件的styles.xml 部分。
在文档中访问隐式样式：
LatentStyles对象支持len()方法，迭代、和通过样式名进行字典式访问：
LatentStyles对象还提供对当前文档中内置样式的默认行为属性的访问。这些默认值为_LatentStyle定义的任何未定义属性以及没有显式潜式定义的内置样式的所有行为属性提供值。有关LatentStyles对象的完整可用属性集，请参阅API文档:
一个隐式样式删除可以通过 delete() 方法。
了解图片及其他一些形状
从概念上讲，Word文档有两个层，一个文本层和一个绘图层。在文本层中，文本对象从左到右、从上到下流动，当先前的页面被填充时，就开始一个新的页面。在绘图层中，绘制对象(称为形状)被放置在任意位置。这些形状有时被称为浮动形状。
图片是可以出现在文本或绘图层中的形状。当它出现在文本层时，它被称为内联形状，或者更具体地说，内联图片。
内联形状被视为一个大文本字符(字符符号)。线的高度增加，以适应形状，形状被包装成一条线，它将适合宽度，就像文本。在它前面插入文本会使它向右移动。通常，一幅画是单独放在一段中，但这不是必需的。它可以在放置它的段落前后有文本。
在编写本文时，python-docx只支持内联图片。可以添加浮动图片。如果您有一个案例，请在问题跟踪器上提交一个特性请求。add_picture()方法将一个指定的图片添加到文档末尾的一个段落中。然而，通过深入挖掘API，您可以在图片的任意一侧放置文本，或者两者都放置。
: 返回从docx加载的文档对象，其中docx可以是.docx文件(字符串)的路径，也可以是类文件对象。如果docx缺少或没有，则加载内置的默认文档“模板”
: 返回新添加到文档末尾的标题段落，其中包含文本，其段落样式由级别决定。如果level为0，样式设置为Title。如果级别是1(或省略)，则使用标题1。否则样式设置为Heading {level}。如果级别在0-9范围之外，就会增加ValueError值。 : 返回新添加到文档末尾的段落，仅包含分页符。 :
返回一个新添加到文档末尾的段落，用文本填充，具有段落样式。文本可以包含制表符(\t)字符，这些字符被转换为制表符的适当XML格式。文本还可以包括换行符(\n)或回车符(\r)，每个换行符都被转换为换行符。 :
返回在文档末尾自己的段落中添加的新图形形状。图片包含image_path_or_stream的图片，根据宽度和高度缩放。如果既没有指定宽度也没有指定高度，则图像将以其实际大小显示。如果只指定了一个，则使用它来计算一个缩放因子，然后应用于未指定的维数，以保持图像的长宽比。图的实际大小使用图像文件中指定的点每英寸(dpi)值计算，如果没有指定值，默认为72 dpi，通常情况下是这样的。 :
添加一个分别具有行和cols行数和表样式的表和列计数的表。样式可以是段落样式对象或段落样式名称。如果样式为空，则表继承文档的默认表样式。 : CoreProperties对象提供对本文档核心属性的读写访问。 : 一个InlineShapes对象，提供对该文档中内联形状的访问。内联形状是一个图形对象，例如图片，包含在一段文本中，表现得像字符符号，像段落中的其他文本一样流动。 :
与文档中各段相对应的段落实例列表，按文档顺序排列。注意，<w:ins>或<w:del>等修订标记中的段落不在此列表中。 : 将此文档保存到path_or_stream，它可以是文件系统位置(字符串)的路径，也可以是类文件对象。 : `sections`对象提供对本文档中每个节的访问。 : 一个`Styles`对象，提供对该文档中的样式的访问。 :
与文档中的表相对应的表实例列表，按文档顺序排列。注意，只有出现在文档顶层的表出现在这个列表中;嵌套在表单元格中的表不会出现。修订标记内的表，如`<w:ins>`或`<w:del>`，也不会出现在列表中
每个属性都是三种类型之一，和以及。字符串属性的长度限制为255个字符，如果没有设置，则返回一个空字符串(")。没有时区的datetime对象，即UTC格式。任何时区转换都是客户端的责任。如果未设置日期属性，则返回None。
python-docx不会自动设置任何文档核心属性，除非将核心属性部分添加到没有核心属性的表示中(非常少见)。如果python-docx添加了一个核心属性部分，那么它包含标题、last_modified_by、修订和修改属性的默认值。如果需要，客户端代码应该更新诸如修订和last_modified_by之类的属性。
: string--主要负责生成资源内容的实体。 : string--此包内容的分类。示例值可能包括:简历、信函、财务预测、提案或技术演示。 : string--文档的完成状态，例如“草稿” : string--对给定上下文中的资源的明确引用，例如ISBN : string--描述性单词或短语可能被用作本文档的搜索词 :
string--最后修改文档的人的姓名或其他标识符(如电子邮件地址) : int此修订的编号，每次保存文档时都会递增。但是请注意，python-docx在保存文档时不会自动增加修订号。
: 这个对象代理的lxml元素。
style用于在单个名称下收集一组格式化属性，并一次性将这些属性应用于内容对象。这促进了整个文档和相关文档的格式一致性，并允许通过以适当的样式更改定义来全局地进行格式更改。
: 返回一个新添加的`style`对象，类型为style_type，并通过名称进行标识。内建样式可以通过为可选的内建参数传递True来定义。 : 返回style_type的默认样式或None(如果没有为该类型定义默认样式)。 : 这个对象代理的lxml元素 :
`LatentStyles`对象提供对隐式样式的默认行为和`_LatentStyle`对象集合的访问，这些对象定义了特定的隐式样式的默认覆盖。
: 用于各种类型的样式对象、段落、字符、表和编号的基类。所有样式对象都继承这些属性和方法。
: **只读**。如果这个样式是内置样式则为`Ture`，`False`就说明这个是自定义（用户样式）。注意，这个值是基于XML中存在的customStyle属性，而不是基于关于哪些样式构建到Word中的特定知识。 : 从文档中删除样式定义。注意，调用此方法不会删除或更改应用于任何文档内容的样式。具有已删除样式的内容项将使用默认样式呈现，文档中未定义样式的任何内容也是如此。 :
代理这个对象的lxml元素。 : 如果在样式库和推荐样式列表中显示此样式被禁止，则为`True`。否则为`False`。为了在样式库中显示，这个值必须为`False`, `quick_style`必须为`True`。 : 可读写的布尔值。
如果这个样式是被锁住的状态则为`True`，一个被锁住状态的样式不能再在样式面板中显示出来或者说不能被文档内容应用。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : 此样式在Word UI中的整数排序控制显示序列的关键字。`None`表示没有定义任何设置，导致Word使用默认值0。样式名用作二级排序键，用于解析具有相同优先级值的样式的排序。 :
如果这个样式显示在样式库中则为`True`，如果该样式在隐藏时应该显示在样式库中，则为`False`。读/写布尔值。 : 如果应用程序在下一次应用于内容时应该使该样式可见，则为`True`。否则`False`。请注意，当将python-docx应用于内容时，它不会自动地为该属性打开具有`True`的样式。
: 如果此样式不是基于另一种样式，则此样式将继承或不继承。 : **只读**。如果这个样式是内置样式则为`Ture`，`False`就说明这个是自定义（用户样式）。注意，这个值是基于XML中存在的customStyle属性，而不是基于关于哪些样式构建到Word中的特定知识。 :
从文档中删除样式定义。注意，调用此方法不会删除或更改应用于任何文档内容的样式。具有已删除样式的内容项将使用默认样式呈现，文档中未定义样式的任何内容也是如此。 : `Font`对象提供对这种样式的字符格式属性(如字体名称和大小)的访问。 : 如果在样式库和推荐样式列表中显示此样式被禁止，则为`True`。否则为`False`。为了在样式库中显示，这个值必须为`False`以及
`quick_style`必须为`True`。 : 可读写的布尔值。 如果这个样式是被锁住的状态则为`True`，一个被锁住状态的样式不能再在样式面板中显示出来或者说不能被文档内容应用。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : 此样式在Word
UI中的整数排序控制显示序列的关键字。`None`表示没有定义任何设置，导致Word使用默认值0。样式名用作二级排序键，用于解析具有相同优先级值的样式的排序。 : 如果这个样式显示在样式库中则为`True`，如果该样式在隐藏时应该显示在样式库中，则为`False`。读/写布尔值。 :
如果应用程序在下一次应用于内容时应该使该样式可见，则为`True`。否则`False`。请注意，当将python-docx应用于内容时，它不会自动地为该属性打开具有`True`的样式。
**只读**。如果这个样式是内置样式则为`Ture`，`False`就说明这个是自定义（用户样式）。注意，这个值是基于XML中存在的customStyle属性，而不是基于关于哪些样式构建到Word中的特定知识。 : 从文档中删除样式定义。注意，调用此方法不会删除或更改应用于任何文档内容的样式。具有已删除样式的内容项将使用默认样式呈现，文档中未定义样式的任何内容也是如此。 :
`Font`对象提供对这种样式的字符格式属性(如字体名称和大小)的访问。 : 如果在样式库和推荐样式列表中显示此样式被禁止，则为`True`。否则为`False`。为了在样式库中显示，这个值必须为`False`以及 `quick_style`必须为`True`。 : 可读写的布尔值。
如果这个样式是被锁住的状态则为`True`，一个被锁住状态的样式不能再在样式面板中显示出来或者说不能被文档内容应用。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : _CharacterStyle对象，该对象表示将自动应用于插入该样式后的新段落的样式。如果没有定义下一段样式，则返回self。分配None或self会删除设置，以便使用相同的样式创建新段落。 :
_CharacterStyle对象提供了对于例如像缩进等段落格式属性这样样式的访问。 : 此样式在Word UI中的整数排序控制显示序列的关键字。`None`表示没有定义任何设置，导致Word使用默认值0。样式名用作二级排序键，用于解析具有相同优先级值的样式的排序。 : 如果这个样式显示在样式库中则为`True`，如果该样式在隐藏时应该显示在样式库中，则为`False`。读/写布尔值。 :
如果应用程序在下一次应用于内容时应该使该样式可见，则为`True`。否则`False`。请注意，当将python-docx应用于内容时，它不会自动地为该属性打开具有`True`的样式。
一个表的风格。表样式为其内容提供字符和段落格式，以及特殊的表格式属性。
: 如果此样式不是基于另一种样式，则此样式将继承或不继承。
: **只读**。如果这个样式是内置样式则为`Ture`，`False`就说明这个是自定义（用户样式）。注意，这个值是基于XML中存在的customStyle属性，而不是基于关于哪些样式构建到Word中的特定知识。 : 从文档中删除样式定义。注意，调用此方法不会删除或更改应用于任何文档内容的样式。具有已删除样式的内容项将使用默认样式呈现，文档中未定义样式的任何内容也是如此。 :
`Font`对象提供对这种样式的字符格式属性(如字体名称和大小)的访问。 : 如果在样式库和推荐样式列表中显示此样式被禁止，则为`True`。否则为`False`。为了在样式库中显示，这个值必须为`False`以及 `quick_style`必须为`True`。 : 可读写的布尔值。
如果这个样式是被锁住的状态则为`True`，一个被锁住状态的样式不能再在样式面板中显示出来或者说不能被文档内容应用。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : _CharacterStyle对象，该对象表示将自动应用于插入该样式后的新段落的样式。如果没有定义下一段样式，则返回self。分配None或self会删除设置，以便使用相同的样式创建新段落。 :
_CharacterStyle对象提供了对于例如像缩进等段落格式属性这样样式的访问。 : 此样式在Word UI中的整数排序控制显示序列的关键字。`None`表示没有定义任何设置，导致Word使用默认值0。样式名用作二级排序键，用于解析具有相同优先级值的样式的排序。 : 如果这个样式显示在样式库中则为`True`，如果该样式在隐藏时应该显示在样式库中，则为`False`。读/写布尔值。 :
如果应用程序在下一次应用于内容时应该使该样式可见，则为`True`。否则`False`。请注意，当将python-docx应用于内容时，它不会自动地为该属性打开具有`True`的样式。
: 返回一个新添加的`_LatentStyle`对象，以覆盖这个潜在样式对象中为具有名称的内置样式定义的继承默认值。 : 0到99之间的整数，指定样式列表和样式库中潜在样式的默认排序顺序。如果没有赋值，则为`None`，这将导致Word使用默认值99。 :
布尔值指定是否隐藏隐式样式的默认行为。隐式样式不会出现在推荐列表或样式库中。 : 布尔值指定是否锁定潜在样式的默认行为。锁定样式不会出现在样式面板或样式库中，也不能应用于文档内容。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : 布尔值指定隐藏样式的默认行为是否在不隐藏时出现在样式库中。 : 布尔值指定隐藏样式的默认行为是否在首次应用于内容时不隐藏。 :
通过这个对象代理lxml : 指定要初始化到这个`LatentStyles`对象中指定的默认值的内置样式的数量。如果XML中没有设置(非常少见)，则没有设置。默认的Word 2011模板将该值设置为276，这是Word 2010中的内置样式。
删除这种潜在的样式定义，以便在包含`LatentStyles`对象中定义的默认值为其每个属性提供有效值。在调用此方法后试图访问此对象上的任何属性将引发`AttributeError`。 : 通过这个对象代理lxml : 三态值，指定是否在推荐列表中显示这种隐式样式。没有一个表示有效值继承自父元素`<w:latentstyles>` :
三态值，指定这种隐式样式是否锁定。锁定样式不会出现在样式面板或样式库中，也不能应用于文档内容。只有在打开文档的格式保护时(通过Developer菜单)，该行为才会激活。 : 此异常应用于的内置样式的名称。 : 整数排序键用于UI中这种隐式样式。 : 三态值，指定当不隐藏时，这种潜在样式是否应该出现在样式库中。没有一个表示有效值应该从其父LatentStyles对象的默认值继承。 :
在下次将样式应用于内容时，指定该样式是否应该将其隐藏属性设置为False。`None`表示有效值应该继承自其父LatentStyles对象指定的默认值。
: 在包含文本并具有由样式ID样式标识的字符样式的段落中追加一个run。文本可以包含制表符(\t)字符，这些字符被转换为制表符的适当XML格式。文本还可以包括换行符(\n)或回车符(\r)，每个换行符都被转换为换行符。 :
WD_PARAGRAPH_ALIGNMENT枚举变量成员，指定了这段的对齐设置。None值表示段落没有直接应用的对齐值，并将从其样式层次结构继承其对齐值。将None赋给此属性会删除任何直接应用的对齐值。 : 删除所有内容后返回相同的段落。段落级别的格式，比如样式，被保留了下来。 :
返回一个新创建的段落，直接插入到这段前面。如果提供了文本，新段落将在一次运行中包含该文本。如果提供了样式，则将该样式分配给新段落。 : 段落格式对象提供对段落格式属性的访问，例如行间距和缩进。 : 本段中<w:r>元素对应的运行实例序列。 :
读/写。[_ParagraphStyle](#_para_obj)对象，表示分配给这段的样式。如果没有为该段落指定显式样式，则其值为文档的默认段落样式。可以用段落样式名称代替段落样式对象。分配None会移除任何应用的样式，使其有效值成为文档的默认段落样式。 : 连接段落中每个运行的文本而形成的字符串。XML中的制表符和换行符分别映射到\t和\n字符。
将文本分配给此属性将导致将所有现有的段落内容替换为包含指定文本的单个运行。文本中的t字符映射到元素，每个\n或\r字符映射到换行符。段落级别的格式，比如样式，被保留了下来。所有运行级格式(如粗体或斜体)都被删除。
: WD_PARAGRAPH_ALIGNMENT枚举变量成员，指定了这段的对齐设置。None值表示段落对齐是从样式层次结构继承而来的。 : 指定段落第一行缩进的相对差异的长度值。一个正数会使第一行缩进。一个负数产生一个挂起缩进。`None`第一行缩进是从样式层次结构继承的。 :
如果段落应该保持“完整”，并且在呈现文档时不跨页边界，则为`True`。`None`它的有效值是从样式层次结构继承的。 : 如果该段落在呈现文档时应与随后的段落保持在同一页上，则为`True`。例如，此属性可用于将一个章节标题保持在与第一段相同的页面上。`None`它的有效值是从样式层次结构继承的。 :
长度值，指定段落左侧空白处和左侧空白处之间的空间。`None`个表示左缩进值是从样式层次结构继承的。使用英寸值对象作为以英寸为单位应用缩进的方便方法。 :
`float`或`Length`，指定段落连续行中基线之间的空间。`None`值表示从样式层次结构继承行间距。浮动值，例如2.0或1.75，表示行距为线高的倍数。`Lenght`如Pt(12)表示间距是固定高度。Pt值类是在点的单位中应用行间距的一种方便方法。分配`None`会重置从样式层次结构继承的行间距。 :
如果段落应该出现在前面段落后面的页面顶部，则为`True`。`None`指出它的有效值是从样式层次结构继承的。 : `Length`，指定段落右侧和右侧之间的空间。`None`表示右缩进值是从样式层次结构继承的。使用`Cm`值对象作为一种方便的方法来应用以厘米为单位的缩进。 :
长度值，指定该段落与后续段落之间出现的间距。`None`表示这个值是从样式层次结构继承的。长度对象提供了方便的属性，例如pt和inch，允许轻松转换到各种长度单位。 : 长度值，指定在该段和前段之间出现的间距。`None`表示这个值是从样式层次结构继承的。Length对象提供了方便的属性，例如pt和cm，可以方便地转换到各种长度单位。 :
`TabStops`对象提供对为这种段落格式定义的选项卡停止的访问。 : 如果一段中的第一行和最后一行与另一段保持在同一页上，则当单词重新标记文档时为`True`。`None`它的有效值是从样式层次结构继承的。
: 代理对象包装元素。运行中的一些属性接受三态值，True、False或None。True与False分别对应开关。False表示属性没有在运行中直接指定，它的有效值是从样式层次结构中获取的。
返回一个InlineShape实例，该实例包含image_path_or_stream标识的图像，并添加到运行的末尾。`image_path_or_stream`可以是路径(字符串)或包含二进制图像的类文件对象。如果既没有指定宽度也没有指定高度，则图像将以其实际大小显示。如果只指定了一个，则使用它来计算一个缩放因子，然后应用于未指定的维数，以保持图像的长宽比。图的本机大小使用图像文件中指定的点每英寸(dpi)值计算，如果没有指定值，默认为72
dpi，yiban情况下是这样的。 : 将一个新添加的_Text对象(对应于一个新的<w:t>子元素)返回到包含文本的run。</w:t>与为运行分配文本给`Run.text`相比这一方法可能更加友好。 : 使运行里面的文本以粗体显示。 : Font对象提供对此运行的字符格式属性(如字体名称和大小)的访问。 :
读/写。三态值。当为True时，将导致运行的文本以斜体显示。 : 读/写。一个[`_CharacterStyle`](#_char_obj)对象，表示应用于此运行的字符样式。如果运行没有直接应用的字符样式，则返回文档的默认字符样式(通常是默认字符字体)。将此属性设置为None会删除任何直接应用的字符样式。
将文本赋给此属性会产生相反的效果，将每个\t字符转换为元素，将每个\n或\r字符转换为元素。任何现有的运行内容都将被替换。运行格式保持不变。
`Run`的下划线样式，可以是一个为None、True、False或WD_UNDERLINE的值。`None`值表示运行没有直接应用的下划线样式，因此将继承包含段落的下划线值。将`None`赋给此属性会删除任何直接应用的下划线值。`False`值表示没有下划线的直接应用的设置，覆盖任何继承值。`True`值表示单下划线。`WD_UNDERLINE`的值用来指定其他的轮廓样式，比如`double、wavy和点星型。
: 代理对象封装元素的父元素，并提供对字符属性(如字体名称、字体大小、粗体和下标)的访问。
: 读/写. 使此字体中的文本以大写字母显示。 : 读/写。使此文本内容以粗体显示。 : 一个`ColorFormat`对象，提供了一种获取和设置该字体文本颜色的方法。 : 读写三态值。如果为True，则将运行中的字符视为复杂的脚本，而不考虑其Unicode值。 : 读/写三态值。当为`True`时，将使运行中的复杂脚本字符以粗体显示。 :
读/写三态值。当为`True`时，将使运行中的复杂脚本字符以斜体显示。 : 读/写三态值。当为`True`时，将使运行中的文本以双删除线贯穿显示。 : 读/写三态值。当为`True`时，将使运行中的文本显示为凸起的页面。 : 读/写三态值。当为`True`时，将导致run中的文本隐藏不显示，除非应用程序设置强制显示隐藏文本。 :
WD_COLOR_INDEX的一个成员，指示应用了高亮显示的颜色，如果没有应用高亮显示，则为空。 : 读写三态值。当为True时，将使运行中的文本显示为压入页面的状态。 : 读/写三态值。当为True时，将导致Run的文本以斜体显示。`None`表示有效值是从样式层次结构继承的。 :
获取或设置此字体实例的字体名称，如果找到匹配的字体，则使其控制的文本出现在指定的字体中。`None`表示字体是从样式层次结构继承的。 : 读/写三态值。当为`True`时，指定在扫描文档以查找拼写和语法时，此运行的内容不应报告任何错误。 : 读/写三态值。当True使运行中的字符看起来好像有一个轮廓，通过在每个字符符号的内外边界上绘制一个像素宽的边框。 :
读/写三态值。当True使运行中的文本具有从右到左的特征时。 : 读/写三态值。当`True`使运行中的文本显示为每个字符都有阴影时。 : 读/写长度值或`None`，以英文单位(EMU)表示字体高度。`None`表字体大小应该从样式层次结构继承。Length是int的子类，具有方便转换为点或其他长度单位的属性。`docx.shared.Pt`类允许方便的点值规范: :
读/写三态值。当`True`时，运行中的小写字符显示为大写字母，比为运行指定的字体大小小两个点。 : 读/写三态值。当True使运行在布局此运行中的字符时，在`FdocGrid`元素中定义的每行设置中使用文档网格字符。 : 读/写三态值。当True时，将使运行中的文本以一条横线穿过该行的中心出现。 :布尔值，指示此字体中的字符是否显示为下标。`None`下标/下标值是从样式层次结构继承的。
: 布尔值，指示此字体中的字符是否显示为上标。`None`表示下标/上标值是从样式层次结构继承的。 : 读/写三态值。当为True时，指定在web页面视图中显示文档时，将隐藏该运行的内容。
: 一个单独的标签停止应用于一个段落或样式。使用包含制表位对象的列表语义进行访问。
: `WD_TAB_LEADER中`的一个成员，指定作为“leader”使用的重复字符，填充此选项卡所跨越的空间。分配None会产生与分配wd_tab_leader . space相同的结果。读/写。 ： 一个长度对象，表示这个制表符从段落内边缘的距离。可能是积极的，也可能是消极的。读/写。
: 在位置添加一个新的制表符停止，长度对象指定制表符停止相对于段落边缘的位置。一个负位置值是有效的，出现在挂起缩进。选项卡对齐默认为左侧，但可以通过将`WD_TAB_ALIGNMENT`枚举的成员作为对齐方式传递来指定。可以通过将`WD_TAB_LEADER`枚举的成员作为leader传递来指定可选的leader字符。 :
移除所有自定义制表位。
: 返回一个宽度`_Column`对象，新添加到最右边的表。 : 返回一个_Row实例，新添加到表的最底部。 : 读/写。`WD_TABLE_ALIGNMENT`或为`None`，指定该表在页边距之间的位置。如果没有指定设置，则会导致从样式层次结构继承有效值。 :
如果可以自动调整列宽以提高单元格内容的适合度，则为`True`。如果表布局是固定的，则为`False`。如果总列宽度超过页面宽度，则在两种情况下都会调整列宽。读/写布尔。 : 表示该表中列序列的_Columns实例。 : 该表中row_idx行的单元格序列。 : 包含此表中的行序列的_Rows实例。 :
读/写。表示应用于该表的样式的`_TableStyle`对象。如果表没有直接应用的样式，则返回文档的默认表样式(通常是普通表)。将None赋给此属性会删除任何直接应用的表样式，导致它继承文档的默认表样式。注意，表样式的样式名称与用户界面中显示的样式略有不同;连字符，如果出现，必须删除。
返回在单元格中内容末尾新添加的段落。如果出现，文本将在一次运行中添加到段落中。如果指定，则应用段落样式。如果没有指定或没有指定样式，结果就好像应用了“普通”样式。注意，单元格中的文本格式可能会受到表样式的影响。文本可以包含制表符(\t)字符，这些字符被转换为制表符的适当XML格式。文本还可以包括换行符(\n)或回车符(\r)，每个换行符都被转换为换行符。 :
在现有单元格内容之后返回新添加到此单元格的表，其中包含行rows和cols列。在表后添加一个空段落，因为Word需要段落元素作为每个单元格中的最后一个元素。 : 返回一个合并的单元格，该单元格是通过将此单元格和other_cell作为对角线跨越矩形区域而创建的。如果单元格没有定义一个矩形区域，就会引发`InvalidSpanError`。 :
单元格中的段落列表。表单元格需要包含至少一个块级元素并以段落结尾。默认情况下，新单元格包含一个段落。只读 : 单元格中的段落列表。表单元格需要包含至少一个块级元素并以段落结尾。默认情况下，新单元格包含一个段落。只读。 : 这个单元格的整个内容作为一个文本字符串。将字符串赋给此属性将所有现有内容替换为在一次运行中包含指定文本的单个段落。
None值表示该单元格的垂直对齐是继承的。分配None会导致删除任何明确定义的垂直对齐，从而恢复继承。 在EMU中设置此单元格的宽度，如果没有设置显式宽度，则为None。
: 与这一行中的单元格对应的`_Cell`实例序列。 : 返回一个表示单元格高度的`Length`对象，如果没有设置显式高度，则返回`None`。 : 引用这一行所属的表对象。
: 与此列中的单元格对应的`_Cell`实例序列。 : 引用此列所属的表对象。 : 在EMU中设置此列的宽度，如果没有设置显式宽度，则为`None`。
: 引用此行集合所属的`Table`对象
提供对部分属性(如页边距和页面方向)的访问。
: `Length`对象，表示本节中所有页的底部空白，单位为英文公制单位。 : `Length`对象，表示从页面底部边缘到页脚底部边缘的距离。如果XML中没有设置，则为None。 : `Length`对象，表示本节中所有页的页槽大小(以英文公制单位表示)。页边距是在内页边距上增加的额外间距，以确保页边距均匀。 :
`Length`对象，表示从页面顶部边缘到页眉顶部边缘的距离。如果XML中没有设置，则为`None`。 : `Length`对象，表示本节中所有页的左边空白处，单位为英文公制单位。 : 本节使用的总页面高度，包括所有的边缘间距值，如页边距。考虑到页面方向，例如，当方向是横向的时候，它的预期值是英寸(8.5)。 :
本节使用的总页面宽度，包括所有的边间距值，如边距。考虑到页面方向，例如，当方向是横向时，字体大小的纸张的预期值为英寸(11)。 : `Length`对象，表示本节中所有页的右边距，单位为英文公制单位。 : `WD_SECTION_START`枚举的成员对应于此部分的初始中断行为，例如`WD_SECTION`。如果部分应该从下一个奇数页开始，则为奇数页。 :
`Length`对象，表示本节中所有页的顶部空白，单位为英文公制单位。
: 读/写。这个内联形状作为Emu实例的显示高度。 : 读/写。这个内联形状作为Emu实例的显示宽度。
低级的绘图元素，如出现在各种文档上下文中的颜色。
分配MSO_THEME_COLOR_INDEX的成员会使type变成MSO_COLOR_TYPE.THEME。任何现有的RGB值都被保留，但被Word忽略。分配None会导致删除所有颜色规范，从而从样式层次结构继承有效的颜色。
: 只读的。MSO_COLOR_TYPE (RGB、THEME或AUTO中的一个)的成员，对应于该颜色的定义方式。如果在此级别没有应用颜色，则其值为`None`，这将导致有效颜色从样式层次结构继承。
python-docx中的长度值表示为标准长度值对象。Length是int的子类，具有int的所有行为。
Length对象是使用一系列方便的构造函数来构造的，允许在最适合上下文的单元中表示值。
: 长度构造函数类的基类:英寸、厘米、毫米、Px和Emu。作为英制公制单位的int计数，914,400到英寸，36,000到毫米。以只读属性的形式提供方便的单位转换方法。不可变的。
: 以厘米表示的等效长度(浮点数)。 : 用英制单位(int)表示的等效长度。 : 以英寸表示的等效长度(浮点数)。 : 以毫米表示的等效长度(浮点数)。
从RGB颜色十六进制字符串返回一个新实例，比如'3C2F80'
在这里可以找到用于python-docx属性设置的各种枚举文档:
: 颜色是预设的主题颜色之一。 : 颜色是自动确定的应用程序。 : 指定背景1的主题颜色。 : 指定背景2的主题颜色。 : 指定被单击超链接的主题颜色。 : 指定超链接的主题颜色。 : 指定文本1的主题颜色。 : 指定文本2的主题颜色。 : 表示使用了多种主题颜色。 : 段落字符被分配以填充整个段落的宽度。 : 用中等字符压缩比证明。 : 具有高字符压缩比。 : 用低字符压缩比证明。
: 根据泰国格式布局对齐。 : 普通(应用于表中)。 : 中等宽度表格列表1所示。 : 文本对齐到单元格的顶部边框。 : 文本对齐单元格的中心。 : 文本对齐单元格的底部。 : 这是OpenXml规范中的一个选项，但不是Word本身。目前还不清楚这种设置会产生什么样的文字行为。如果你发现了请让我们知道，我们将更新这个文件。否则，最好避免这种选择。
指定要应用的标准预设颜色。用于字体高亮显示和其他应用程序。
: 自动颜色，默认通常是黑色。 : 25%深浅的灰色。 : 50%深浅的灰色。 : 行间距总是至少指定的数量。金额是单独指定的。 : 行间距正好是规定的量。金额是单独指定的。 : 线间距指定为线高的倍数。改变字体大小会相应地改变行距。 : 单一的间隔(默认)。 : 调整行高度以适应行的最高值。 : 行高度至少是指定的最小值。 : 行高度是一个精确的值。 : 新章节从下一页开始 :
: 指定要用作带格式化选项卡的标题的字符。
: 表或行与第一列排列在最左边的位置。 : 表或行与第一列排列在最右边的位置。
: 指定应用于一系列字符的下划线的样式
: 没有下划线。此设置覆盖所有继承的下划线值，因此可用于从从其包含段落中继承下划线的运行中删除下划线。注意，这与为Run.underline分配`None`不一样。`None`是一个有效的赋值，但会导致运行继承其下划线值。分配WD_UNDERLINE。没有人会无条件地关闭下划线。 :
一行。注意，此设置是只写的，因为在运行时使用此设置会返回`True`(而不是WD_UNDERLINE.SINGLE)。 : 只在单个字下面加划线。 : 一种交替的点-点-划模式。 : 交替使用加粗点和加粗线。 : 一种交替的重点-点-划模式。 : 一条加粗的波浪线。
