Slides对象
使用Presentation的slides属性可以访问Slides对象。 它不打算直接构造。
class pptx.slide.Slides
属于Presentation实例的幻灯片序列，具有访问单个幻灯片的列表语义。
支持索引访问，len()和迭代。
- add_slide(slide_layout )
返回一个新添加的幻灯片，该幻灯片继承了slide_layout的布局。
- get(slide_id，default = None )
返回此演示文稿中由整数slide_id标识的幻灯片，如果找不到，则返回默认值。
- index(幻灯片)[来源]
将幻灯片映射到表示此幻灯片集合中从零开始的位置的整数。
在幻灯片上不存在时引发ValueError。
Slide对象
Slide通过索引从Slides或作为的返回值访问单个对象add_slide()。
class pptx.slide.Slide
滑动对象。提供对形状和幻灯片级属性的访问。
- background
_Background对象提供幻灯片背景属性。
无论幻灯片是否覆盖默认背景或继承默认背景，此属性都将返回_Background对象。
确定这些条件中的哪一个适用于此幻灯片是使用follow_master_background属性完成的。
每次调用同一幻灯片对象都返回相同的_Background对象。
- element
该对象代理的lxml元素。
- follow_master_background
如果此幻灯片继承了幻灯片母版背景，则为true。
分配False会导致从主控的后台继承被中断；
如果此幻灯片没有自定义背景，则会添加默认背景。
如果此幻灯片已存在自定义背景，则将False赋值无效。
分配为True会导致删除此幻灯片的所有自定义背景，并恢复从母版继承的内容。
- has_notes_slide
如果此幻灯片具有注释幻灯片，则返回True，否则返回False。
注释幻灯片由notes_slide创建(如果不存在)；
使用此属性可以测试笔记幻灯片，而不会产生创建笔记幻灯片的副作用。
- name
表示此幻灯片的内部名称的字符串。 如果未分配名称，
则返回一个空字符串(‘’)。为该属性分配空字符串或无将导致删除任何名称。
- notes_slide
返回此幻灯片的NotesSlide实例。 如果幻灯片没有便笺幻灯片，则会创建一个。
每次调用都返回相同的单个实例。
- placeholders
此幻灯片中包含占位符形状序列的SlidePlaceholders实例。
- shapes
包含形状对象序列的SlideShapes实例出现在此幻灯片上。
- slide_id
在此演示文稿中唯一标识此幻灯片的整数值。 如果通过添加，
重新排列或删除幻灯片来更改幻灯片序列中幻灯片的位置，则幻灯片ID不会更改。
- slide_layout
此幻灯片继承其外观的SlideLayout对象。
SlideLayouts对象
SlideLayouts对象是使用SlideMaster的slide_layouts属性访问的，通常是:
from pptx import Presentation
prs = Presentation()
slide_layouts = prs.slide_master.slide_layouts
为方便起见，由于大多数演示文稿只有一个幻灯片母版，
因此SlideLayouts可以直接从Presentation对象访问第一个母版的集合 ：
slide_layouts = prs.slide_layouts
此类不能直接构造。
class pptx.slide.SlideLayouts
属于幻灯片母版的幻灯片布局顺序。
支持索引访问，len()，迭代，index()和remove()。
- get_by_name(name，default = None )
返回具有名称或没有找到的默认值的SlideLayout对象。
- index(slide_layout )
在此集合中返回slide_layout的从零开始的索引。
如果此集合中不存在slide_layout，则引发ValueError。
- part
包含此对象的包装部件
- remove(slide_layout )
从集合中删除slide_layout。
使用slide_layout时引发ValueError；
不能删除作为一张或多张幻灯片的基础的幻灯片布局。
SlideLayout对象
class pptx.slide.SlideLayout(element，part )
幻灯片布局对象。提供对占位符，常规形状和幻灯片布局级别属性的访问。
- placeholders
在此幻灯片布局中包含占位符形状序列的LayoutPlaceholders实例，按idx顺序排序。
- shapes
包含出现在此幻灯片布局上的形状序列的LayoutShapes实例。
- slide_master
此幻灯片版式将从其继承属性的幻灯片母版。
- used_by_slides
基于此幻灯片布局的幻灯片对象的元组。
- SlideMasters对象
SlideMasters对象是通过slide_masters属性来访问的，通常是:
from pptx import Presentation
prs = Presentation()
slide_masters = prs.slide_masters
为方便起见，由于大多数演示文稿只有一个幻灯片母版，
因此可以直接从Presentation对象访问第一个母版而无需索引集合：
slide_master = prs.slide_master
此类不能直接构造。
class pptx.slide.SlideMasters
SlideMaster属于演示文稿的对象序列。
具有列表访问语义，支持索引访问，len()和迭代。
- part
包含此对象的包装部件
SlideMaster对象
class pptx.slide.SlideMaster(element，part )
滑动主对象。提供对幻灯片布局的访问。从继承对占位符，
常规形状和幻灯片母版级属性的访问_BaseMaster。
- slide_layouts
SlideLayouts对象，可以访问此幻灯片母版的布局。
SlidePlaceholders对象
class pptx.shapes.shapetree.SlidePlaceholders(element，parent )
幻灯片上占位符形状的集合。支持对其包含的占位符len()的idx值进行迭代， 和字典式查找。
NotesSlide对象
class pptx.slide.NotesSlide(element，part )
注释幻灯片对象。可在注释讲义页面上访问幻灯片注释占位符和其他形状。
- background
_Background对象提供幻灯片背景属性。
无论幻灯片，母版或布局是否具有明确定义的背景，此属性都将返回_Background对象。
每次调用同一幻灯片对象都返回相同的_Background对象。
- element
该对象代理的lxml元素。
- name
表示此幻灯片的内部名称的字符串。如果未分配名称，则返回一个空字符串('')。
None为该属性分配空字符串或 将导致删除任何名称。
- notes_placeholder
返回此笔记幻灯片上的笔记占位符，该形状包含实际的笔记文本。
如果没有注释占位符，则返回None；否则返回false。
尽管这可能很少见，但如果Notes主文件没有正文占位符，
或者如果Notes占位符已从Notes幻灯片中删除，则可能会发生这种情况。
- notes_text_frame
返回此便笺幻灯片上便笺占位符的文本框架；如果没有便笺占位符，则返回无。
这是一种快捷方式，可以适应将简单的“注释”文本添加到注释“页面”的常见情况。
- part
包含此对象的包装部件
- placeholders
在此笔记幻灯片中包含占位符形状序列的NotesSlidePlaceholders实例。
- shapes
一个NotesSlideShapes实例，其中包含出现在此笔记幻灯片上的形状对象序列。
Note
#!/usr/bin/python
#coding:utf-8
from pptx import Presentation
# 加载一个ppt文件
prs = Presentation('pptx/zf.pptx')
# 使用Presentation的slides属性访问slides对象
slides = prs.slides
# 返回一个新添加的幻灯片，该幻灯片继承了slide_layout的布局。
addSlide = slides.add_slide
# 循环遍历slides
for slide in slides:
# 返回此演示文稿中由整数slide_id标识的幻灯片，如果找不到，则返回默认值。
get_slide = slides.get(slide.slide_id)
# 返回幻灯片映射到表示此幻灯片集合中从零开始的位置的整数
index = slides.index(get_slide)
pass
# 返回通过索引slides中的第一个对象
slide = slides[0]
# 返回幻灯片背景属性的对象
background = slide.background
# 返回该对象代理的lxml元素
element = slide.element
# follow_master_background属性可以确定哪些条件适用于此幻灯片
# True 如果此幻灯片继承了幻灯片母版背景。
# 分配False会导致从主控的后台继承中断。如果此幻灯片没有自定义背景，则会添加默认背景。
# 如果此幻灯片已存在自定义背景，则分配False无效。
# 分配True会导致删除此幻灯片的所有自定义背景，并恢复从母版的继承。
follow_master_background = slide.follow_master_background
# 如果此幻灯片具有注释幻灯片，则返回True，否则返回False。
# 一张便笺幻灯片是通过notes_slide不存在的幻灯片创建的。
# 使用此属性可以测试笔记幻灯片，而不会产生创建笔记幻灯片的副作用。
has_notes_slide = slide.has_notes_slide
# 表示此幻灯片的内部名称的字符串。如果未分配名称，则返回一个空字符串('')。
slide.name = 'HaI\'s name'
name = slide.name
# 返回NotesSlide此幻灯片的实例。
# 如果幻灯片没有便笺幻灯片，则会创建一个。每次调用都返回相同的单个实例。
notes_slide = slide.notes_slide
# _Background 提供幻灯片背景属性的对象。
# _Background无论幻灯片，母版或布局是否具有明确定义的背景，此属性都将返回一个对象。
background = notes_slide.background
# 返回该对象代理的lxml元素。
element = notes_slide.element
# 表示此幻灯片的内部名称的字符串。如果未分配名称，则返回一个空字符串('')。
# None为该属性分配空字符串或 将导致删除任何名称。
notes_slide.name = 'HaI\'s name'
name = notes_slide.name
# 返回此笔记幻灯片上的笔记占位符，该形状包含实际的笔记文本。
# 如果没有注释占位符，则返回None；
# 尽管这可能很少见，但如果Notes主文件没有正文占位符，或者如果Notes占位符已从Notes幻灯片中删除，则可能会发生这种情况。
notes_placeholder = notes_slide.notes_placeholder
# 返回此笔记幻灯片上笔记占位符的文本框架，或者None如果没有笔记占位符，则返回该文本框。
# 这是一种快捷方式，可以适应将简单的“注释”文本添加到注释“页面”的常见情况。
notes_text_frame = notes_slide.notes_text_frame
# 包含此对象的包装部件
part = notes_slide.part
# notesslideplaceholder的一个实例，其中包含了本注释幻灯片中占位符形状的序列。
placeholders = notes_slide.placeholders
# NotesSlideShapes的一个实例，其中包含出现在这张notes幻灯片上的形状对象的序列。
shapes = notes_slide.shapes
# 返回幻灯片中包含占位符形状序列的slideplaceholder实例。
placeholders = slide.placeholders
# 返回包含出现在此幻灯片上的形状对象序列的幻灯片幻灯片实例。
shapes = slide.shapes
# 返回在此演示文稿中唯一标识此幻灯片的整数值。
# 如果通过添加，重新排列或删除幻灯片来更改幻灯片序列中幻灯片的位置，则幻灯片ID不会更改。
slide_id = slide.slide_id
# 返回此幻灯片继承外观的对象。
slide_layout = slide.slide_layout
# SlideLayouts对象是使用SlideMaster的slide_layouts属性访问的
slide_layouts = prs.slide_master.slide_layouts
# 由于大多数演示文稿只有一个幻灯片母版，因此SlideLayouts可以直接从Presentation对象访问第一个母版的集合 ：
slide_layouts = prs.slide_layouts
# 循环遍历slide_layouts
for slide_layout in slide_layouts:
# 返回具有名称或没有找到的默认值的 SlideLayout对象。
get_by_name = slide_layouts.get_by_name(slide_layout.name)
# 返回在此集合中返回slide_layout的从零开始的索引。
# 如果此集合中不存在slide_layout，则引发ValueError 。
index = slide_layouts.index(slide_layout)
# 返回包含此对象的包装部件
part = slide_layout.part
# 返回包含此对象的包装部件
# 使用slide_layout时引发ValueError;不能删除作为一张或多张幻灯片的基础的幻灯片布局。
# 这里因引发ValueError错误，先注释
# remove = slide_layouts.remove(slide_layout)
# 返回包含此幻灯片布局中占位符形状序列的layoutplaceholder实例，按idx顺序排序。
placeholders = slide_layout.placeholders
# 返回包含此幻灯片布局中出现的形状序列的LayoutShapes实例。
shapes = slide_layout.shapes
# 此幻灯片版式将从其继承属性的幻灯片母版。
slide_master = slide_layout.slide_master
# 基于此幻灯片布局的幻灯片对象的元组。
used_by_slides = slide_layout.used_by_slides
pass
# SlideMasters对象是通过slide_masters属性来访问的
slide_masters = prs.slide_masters
# 由于大多数演示文稿只有一个幻灯片母版，因此可以直接从Presentation对象访问第一个母版而无需索引集合：
slide_master = prs.slide_master
# 返回包含此对象的包装部件
part = slide_master.part
# SlideLayouts对象，提供对该幻灯片主布局的访问。
slide_layouts = slide_master.slide_layouts