讲师中心 微信公众号
AI工具推荐 视频效率加速

Python-docx 中设置页面宽度与高度的正确方法

胖静君_3543

胖静君_3543

发布时间:2026-01-25 11:52:25

|

330人浏览过

|

来源于php中文网

原创

Python-docx 中设置页面宽度与高度的正确方法

在使用 python-docx 修改 word 文档页面尺寸时,`page_width` 和 `page_height` 是可读写属性(而非方法),错误地将其当作函数调用(如 `section.page_width(...)`)会导致 `'twips' object is not callable` 异常。

python-docx 库中,Section 对象的 page_width 和 page_height 属性属于 Length 类型(底层为 Twips 单位封装),它们是属性(property),不是可调用的方法。因此,必须使用赋值语法(=)进行设置,而非函数调用语法(())。

✅ 正确写法如下:

from docx import Document
from docx.shared import Inches

doc = Document()
section = doc.sections[0]

# ✅ 正确:直接赋值(支持 Inches、Cm、Pt、Emu 等单位)
section.page_width = Inches(5)
section.page_height = Inches(5)

# 其他常用单位示例:
# section.page_width = Cm(12.7)      # 12.7 厘米
# section.page_width = Pt(432)        # 432 磅(约 6 英寸)
# section.page_width = Emu(914400)    # 1 英寸 = 914400 EMU(English Metric Units)

doc.save("custom_size.docx")

⚠️ 注意事项:

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 不要写成 section.page_width(Inches(5)) 或 section.page_width = Inches(5)() —— 后者会尝试调用 Twips 实例,引发 TypeError: 'Twips' object is not callable;
  • 所有长度单位需通过 docx.shared 模块导入(如 Inches, Cm, Pt, Emu),不可直接传入浮点数或字符串;
  • 页面尺寸修改仅对当前 Section 生效;若文档含多个节(section),需遍历 doc.sections 分别设置;
  • 设置后务必调用 doc.save(...) 才能持久化到文件。

? 小技巧:可通过 print(section.page_width.inches) 快速验证当前值(单位自动转换),便于调试。

立即学习“Python免费学习笔记(深入)”;

总结:牢记 page_width / page_height 是属性而非方法——赋值即生效,调用即报错。这是 python-docx 中常见的“属性误用”陷阱,掌握这一原则,也能避免类似 left_margin、top_margin 等其他 Length 类型属性的误操作。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3260

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

269

2026.02.03

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1858

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2984

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6264

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6229

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7794

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

11854

2024.04.29

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn