python-pptx去除形状默认的阴影

文章目录

  • 效果
  • 原理
      • [1. 阴影继承机制解析](#1. 阴影继承机制解析)
      • [2. XML层操作细节](#2. XML层操作细节)
      • [3. 注意事项](#3. 注意事项)
  • 扩展应用
      • [1. 批量去除阴影](#1. 批量去除阴影)
      • [2. 复合效果控制](#2. 复合效果控制)

效果

右边这个是直接添加一个形状。可以看到它会默认被赋予一个阴影。

然而,这个东西在特定的场合,其实是我们所不需要的。

那怎么把这个阴影给消掉呢?

左边这个就是我们用代码实现的,没有阴影的效果。

怎么做到的呢?

咱直接给出代码:

复制代码
from pptx.util import Inches, Pt
from pptx.enum.shapes import MSO_SHAPE
from pptx import Presentation

prs = Presentation()

slide_layout = prs.slide_layouts[0]
slide = prs.slides.add_slide(slide_layout)

# 定义矩形的位置和尺寸(以英寸为单位)
left = Inches(1)
top = Inches(1)
width = Inches(3)
height = Inches(2)

# 添加矩形
rectangle = slide.shapes.add_shape(
   MSO_SHAPE.RECTANGLE,
   left, top, width, height
)

rectangle.shadow.inherit = False

prs.save("example.pptx")

核心就是这句代码:

复制代码
rectangle.shadow.inherit = False

原理

1. 阴影继承机制解析

  • 默认继承逻辑 :PowerPoint形状的阴影效果继承自模板/主题的effectLst元素。当该XML元素不存在时,形状自动继承上级样式(返回inherit=True
  • 显式覆盖机制 :通过rectangle.shadow.inherit = False强制创建空的effectLst元素,这会:
    • 中断样式继承链
    • 清空所有视觉效果(包括阴影/发光/反射等)
    • 使effectLst进入"显式定义"状态(此时inherit返回False)

2. XML层操作细节

xml 复制代码
<!-- 默认状态(无effectLst元素) -->
<p:spPr>
    <!-- 继承主题效果 -->
</p:spPr>

<!-- 执行inherit=False后的状态 -->
<p:spPr>
    <a:effectLst/>  <!-- 空效果列表 -->
</p:spPr>

该操作等效于在PPT界面中:
右键形状 → 设置形状格式 → 效果 → 阴影 → 无阴影

3. 注意事项

  • 副作用:该方法会同时移除其他视觉效果(如发光、柔化边缘等),如需保留其他效果需手动重建
  • 性能影响 :频繁操作effectLst可能引发XML结构重排(类似DOM操作)
  • 样式恢复 :设置inherit=True将删除effectLst元素,恢复继承关系

扩展应用

1. 批量去除阴影

python 复制代码
for shape in slide.shapes:
    if shape.has_shadow:
        shape.shadow.inherit = False

2. 复合效果控制

python 复制代码
# 单独关闭阴影但保留发光效果(需API支持)
shape.shadow.inherit = False
shape.glow.inherit = True  # 需要底层XML结构调整

特别提示 :当前python-pptx API对effectLst的控制粒度较粗,精细控制建议直接操作shape._element的XML结构

相关推荐
nbsaas-boot2 小时前
Java 正则表达式白皮书:语法详解、工程实践与常用表达式库
开发语言·python·mysql
仗剑_走天涯2 小时前
基于pytorch.nn模块实现线性模型
人工智能·pytorch·python·深度学习
chao_7892 小时前
二分查找篇——搜索旋转排序数组【LeetCode】两次二分查找
开发语言·数据结构·python·算法·leetcode
一斤代码2 小时前
vue3 下载图片(标签内容可转图)
前端·javascript·vue
风无雨2 小时前
GO 启动 简单服务
开发语言·后端·golang
斯普信专业组2 小时前
Go语言包管理完全指南:从基础到最佳实践
开发语言·后端·golang
3Katrina3 小时前
深入理解 useLayoutEffect:解决 UI "闪烁"问题的利器
前端·javascript·面试
coderlin_4 小时前
BI布局拖拽 (1) 深入react-gird-layout源码
android·javascript·react.js
我是苏苏4 小时前
C#基础:Winform桌面开发中窗体之间的数据传递
开发语言·c#
伍哥的传说4 小时前
React 实现五子棋人机对战小游戏
前端·javascript·react.js·前端框架·node.js·ecmascript·js