python-docx中文文档之文件类

python-docx中文文档之文档类

这是一篇推荐的入门文章：python-docx 使用教程
官方的文档在这里。

###文档类

文档对象及其包含的对象, 原始网页在1。

####创建文档实例

docx.Document(docx=None)

返回从docx 创建的文档对象，参数docx 可以是.docx文档的存储路径，或者是一个 file-like对象，如果参数docx 缺失或None，就会加载内置默认的文档模板。

####文档实例中的方法及属性

#####add_heading

add_heading(text=u'', level=1)

返回一个创建在文档实例末尾的标题，这个标题内容是参数text，内容的格式由参数 level指定。如果level=0 则设置为文章标题，level=1或不填，则设置为标题1格式 ，否则使用标题level格式。如果level的值不在0-9的范围，则引发异常ValueError。

#####add_page_break

 add_page_break()

增加分页符。

#####add_paragraph

add_paragraph(text=u'', style=None)

返回一个在文档实例末尾增加的段落，段落内容由参数text指定，段落格式由参数style指定。参数text 可以包含制表符 \t，制表符会转换为合适的 XML格式；参数text 也可以包含换行符\n，回车符\r，这两个符号都会会转换为换行。

#####add_picture

add_picture(image_path_or_stream, width=None, height=None)

返回一个创建在文档实例末尾的图片形状（picture shape）。参数image_path_or_stream 指定图片的路径。参数width指定图片的宽度，参数height指定图片的高度，如果这两个参数都不指定，则加载的图片为原始图片大小。如果两个参数只指定一个，那么会根据指定的参数计算一个比例系数，用这个比例系数计算另一个参数的大小。原始图片的大小根据图片文件的dpi值计算，默认是72 dpi。

#####add_section

add_section(start_type=2)

返回创建在文档实例末尾的一节。可选参数start_type 必须是枚举类型WD_SECTION_START中的元素。如果不指定，默认是WD_SECTION.NEW_PAGE。

#####add_table

add_table(rows, cols, style=None)

在文档实例中创建一个rows 行，cols列的表格实例。表格的格式由参数style指定，参数style 必须是段落格式对象（paragraph style object ）或者段落格式名字（paragraph style name），如果style=None，则使用文档实例中的默认表格格式。

#####core_properties

core_properties

可读可写。文档实例的核心属性。

#####inline_shapes

inline_shapes

访问文档实例中的inline_shapes形状。

#####paragraphs

paragraphs

返回文档实例中的段落实例列表，按照在文档实例中的出现顺序排列。注意，含有修订标志比如 或的段落实例不会出现在该列表中。

#####part

part

The DocumentPart object of this document.

#####save

save(path_or_stream)

保存该文档实例到path_or_stream，参数path_or_stream可以是文档路径或者是file-like 对象。

#####sections

sections

访问文档实例中的每一节。

#####settings

settings

访问文档实例的设置。

#####styles

styles

访问文档实例中的格式。

#####tables

tables

返回文档实例中表格实例的列表。注意，该列表只包含出现在文档实例顶层的表格实例，如果是嵌套在表格中某一格的表格，则不会出现在该列表中；如果有修订标志比如 or 的表格也不会出现在该列表中。

---