Python-pptx Presentations

Python-pptx Presentations_第1张图片
image

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

from pptx import Presentation

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

# 加载一个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

# !/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')

你可能感兴趣的:(java,python,编程语言,数据库,linux)