Python-pptx Presentations

In |

image

使用Presentation()函数打开一个演示文稿，该函数直接由pptx包提供：

1
from pptx import Presentation

该函数返回一个Presentation对象，该对象是包含构成表示的组件的图形的根，
例如 幻灯片，形状等。通过遍历图形来引用所有现有的表示组件，
并通过在对象的容器上调用方法来将新对象添加到图形中。
因此，通常不会直接构造python-pptx对象。
例：

1
2
3
4
5
6
7
8
#  加载一个ppt文件
prs = Presentation('pptx/zf.pptx')

#  第一张幻灯片中的第一个形状
sp = prs.slides[0].shapes[0]

#  向第一张幻灯片中添加图片形状
pic = prs.slides[0].shapes.add_picture('image/bg2.jpg', 100, 100, 100, 100)

Presentation功能

此功能是使用演示文件必须导入的唯一参考。典型用法与许多其他类进行交互，
但是由于使用其包含对象的属性或方法访问它们时，无需构造它们。
class pptx.Presentation(pptx = None )
返回Presentation从pptx加载的对象，其中pptx可以是.pptx文件(字符串)的路径，
也可以是类似文件的对象。如果 缺少pptx或None，则将加载内置的默认演示文稿“模板”。

Presentation对象

class pptx.presentation.Presentation
PresentationML(PML)演示文稿。不打算直接构造。
使用pptx.Presentation()打开或创建演示文稿。

  • core_properties

    拥有此演示文稿的读取/写入Dublin Core文档属性的CoreProperty实例。

  • notes_master

    此演示文稿的NotesMaster实例。如果演示文稿没有便笺母版，
    则从默认模板创建一个便笺本并将其返回。每次调用都返回相同的单个实例。

  • save(file )

    将此演示文稿保存到file，其中file可以是文件的路径(字符串)或类似文件的对象。

  • slide_height

    本演示文稿中的幻灯片高度，以英制公制(EMU)为单位。
    如果未定义幻灯片宽度，则返回None。读/写。

  • slide_layouts

    属于此演示文稿的第一个SlideMaster的SlideLayout实例的序列。
    一个演示文稿可以有多个幻灯片母版，每个母版都有自己的一组布局。
    对于演示文稿只有一个幻灯片母版的常见情况，此属性很方便。

  • slide_master

    属于此演示文稿的第一个SlideMaster对象。
    通常，演示文稿只有一个幻灯片母版。
    在这种常见情况下，此属性提供了更简单的访问。

  • slide_masters

    属于此演示文稿的SlideMaster对象的序列

  • slide_width

    本演示文稿中的幻灯片宽度，以英语公制单位(EMU)为单位。
    如果未定义幻灯片宽度，则返回None。读/写。

  • slides

    slides对象，其中包含此演示文稿中的幻灯片

CoreProperties对象

每个Presentation对象都有一个CoreProperties通过其core_properties属性访问的对象，
该属性提供对文档的所谓核心属性的读/写访问。
核心属性是作者，类别，评论，content_status，已创建，标识符，关键字，语言，
last_modified_by，last_printed，modified，修订，主题，标题和版本。

每个属性是str，datetime.datetime或int这三种类型之一。
字符串属性的长度限制为255个字符，如果未设置，则返回一个空字符串(‘’)。
日期属性被分配并作为没有时区的datetime.datetime对象返回，即在UTC中。
任何时区转换均由客户负责。 如果未设置，日期属性将返回无。

python-pptx不会自动设置任何文档核心属性，
除非将核心属性部分添加到不包含该属性的演示文稿中(非常少见)。
如果python-pptx添加了核心属性部分，则它包含标题，last_modified_by，
修订版和修改后属性的默认值。如果需要该行为，
客户端代码应显式更改诸如revend和last_modified_by之类的属性。

class pptx.opc.coreprops.CoreProperties

  • author

    string –主要负责制作资源内容的实体。

  • category

    string –此软件包内容的分类。值示例包括：简历，信函，财务预测，提案或技术演示。

  • comments

    string –资源内容的帐户。

  • content_status

    string –文档的完成状态，例如“草稿”

  • created

    datetime –最初创建文档的时间

  • identifier

    string –在给定上下文(例如ISBN)中对资源的明确引用。

  • keywords

    string –描述性词或短短语可能会用作本文档的搜索词

  • language

    string -文档所用的语言

  • last_modified_by

    string –上次修改文档的人的姓名或其他标识符(例如电子邮件地址)

  • last_printed

    datetime –文档上次打印的时间

  • modified

    datetime –文档上次修改的时间

  • revision

    int –此修订版的编号，每次保存文档时，PowerPoint®客户端将其递增一次。
    但是请注意，版本号不会由python-pptx自动增加。

  • subject

    string –资源内容的主题。

  • title

    string –给资源的名称。

  • version

    string –自由格式的字符串

Note

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
#  !/usr/bin/python
#  coding:utf-8
from pptx import Presentation
import sys
#  加载一个ppt文件
prs = Presentation('pptx/zf.pptx')

#  在第一张幻灯片中获得对第一个形状的引用
sp = prs.slides[0].shapes[0]

#  向第一张幻灯片中添加图片形状
pic = prs.slides[0].shapes.add_picture('image/bg2.jpg', 100, 100, 100, 100)

#  此演示文稿的NotesMaster实例。如果演示文稿没有便笺母版，
则从默认模板创建一个便笺本并将其返回。每次调用都返回相同的单个实例。
note = prs.notes_master

#  本演示文稿中的幻灯片高度，以英制公制(EMU)为单位。
None如果未定义幻灯片宽度，则返回。读/写。
height = prs.slide_height

#  属于此演示文稿的第一个SlideMaster的SlideLayout实例的序列。 
一个演示文稿可以有多个幻灯片母版，每个母版都有自己的一组布局。 
对于演示文稿只有一个幻灯片母版的常见情况，此属性很方便。
layouts = prs.slide_layouts

#  属于此演示文稿的第一个SlideMaster对象。 
通常，演示文稿只有一个幻灯片母版。 
在这种常见情况下，此属性提供了更简单的访问。
master = prs.slide_master

#  属于此演示文稿的SlideMaster对象的序列
masters = prs.slide_masters

#  本演示文稿中的幻灯片宽度，以英语公制单位(EMU)为单位。
如果未定义幻灯片宽度，则返回None。读/写。
width = prs.slide_width

#  slides对象，其中包含此演示文稿中的幻灯片
slides = prs.slides

#  每个Presentation对象都有一个CoreProperties通过其core_properties属性访问的对象，
该属性提供对文档的所谓核心属性的读/写访问
core_properties = prs.core_properties

core_properties.author = 'HaI'
core_properties.category = 'python-pptx'
core_properties.comments = 'HaI\'s comments'
core_properties.content_status = "draft"
core_properties.identifier = 'HaI\'s identifier'
core_properties.keywords = 'HaI\'s keywords'
core_properties.language = 'utf-8'
core_properties.last_modified_by = 'HaI\'s last_modified_by'
core_properties.subject = 'HaI\'s subject'
core_properties.title = 'HaI\'s title'
core_properties.version = 'v1.0.0'

#  string –主要负责制作资源内容的作者。
author = core_properties.author
#  string –此软件包内容的分类。值示例包括：简历，信函，财务预测，提案或技术演示。
category = core_properties.category
#  string –资源内容的帐户。
comments = core_properties.comments
#  string –文档的完成状态，例如“草稿”
content_status = core_properties.content_status
#  datetime –最初创建文档的时间
created = core_properties.created
#  string –在给定上下文(例如ISBN)中对资源的明确引用。
identifier = core_properties.identifier
#  string –描述性词或短短语可能会用作本文档的搜索词
keywords = core_properties.keywords
#  string -文档所用的语言
language = core_properties.language
#  string –上次修改文档的人的姓名或其他标识符(例如电子邮件地址)
last_modified_by = core_properties.last_modified_by
#  datetime –文档上次打印的时间
last_printed = core_properties.last_printed
#  datetime –文档上次修改的时间
modified = core_properties.modified
#  int –此修订版的编号，每次保存文档时，PowerPoint®客户端将其递增一次。
#  但是请注意，版本号不会由python-pptx自动增加。
revision = core_properties.revision
#  string –资源内容的主题。
subject = core_properties.subject
#  string –给资源的名称。
title = core_properties.title
#  string –自由格式的字符串
version = core_properties.version

prs.save('pptx/zf-01.pptx')
-------------本文结束感谢您的阅读-------------
0%