win32com操作word之Application&Documents接口学习
作者:一灯编程
win32com和微软的word接口文档有什么关系
先回答一个网友私信问题: win32com和微软的word接口文档有什么关系
win32com的底层调用的是word的接口,理论上,想查看win32com的接口情况,只需要看微软官方的文档即可。文档地址: learn.microsoft.com/zh-cn/dotne…
令入门者云里雾里的API关系
微软word接口文档的组织形式说不上有什么问题,但其接口规模巨大(接近900个,每个接口中少则十几个,多则几百个的属性和方法)的接口及错综综复杂的接口 交叉引用足以将一部分入门者拒之门外,着实繁杂。
往往看到一个接口即便有详细的说明,就是无法知晓如何使用,各种尝试也不得要领,往往最常见的问题是:到底谁来调用这个接口。
要想快速抓住word编程的七寸,请一定要认真阅读下方的讲解。
第一点 回忆一下,我们是如何操作一个文档的
- 1、打开客户端
- 2、创建或打开一个文档
- 3、选中某些资源或鼠标点击准备写入内容
- 4、设置格式:页面设置、字体颜色、缩进等等
- 5、保存文档
- 6、关闭客户端
瞧,其实就那么简单,别看文档写得乌泱乌泱的,从文档操作的角度去思考,其实这个事并没有那么复杂。现在只需要记住:
- Application接口是用来控制客户端的启动和关闭的,甭管它有多少个直接子级API
- Documents接口是用来创建和打开文档的,通过Application.Documents即可调用。记住创建文档和打开文档回返回一个Document对象,要使用变量接受这个对象,这样才方便我们对这个文档进行操作。
现在再回过来对照,客户端打开了,文档也有了,那使用什么方法来选中资源呢?接口中有Selection和Range可以实现选中文档的资源,官方推荐在文档级编程中,优先使用Range接口。 这不来了嘛,就是用Range接口来选中资源。那么谁才有这个资格来调用Range接口呢?答案是:Document,也就是文档对象,所以上面提到,创建文档或保存文档需要使用变量来接受,就是为了方便后续的操作。
第二点 字体、字号、行间距、页面设置等等这些如何实现呢
先将word的资源分类
- 1、内容类资源,如文字、图片、表格、图表、形状及公式等
- 2、文档设置类资源,如页眉页脚、文档页面设置
上方两点分类,通通都能通过Document接口搞定,因为这些资源只在文档中才存在呀,即便是页面设置,也是设置某个文档的!所以,即便看对应的文档,我们也能快速知晓调用者就是Document。 再者,如果选中了某段文字,想为文字设置格式,各种格式也有独立的接口,那么又是谁来调用这些格式接口呢?答案自然是:Range。使用Range选中某个资源,那自然是使用Range来调用这些格式接口。 瞧瞧,就是那么简单。
第二课的代码演示 (并不完全和视频教程中的一样)
ok,进入第二集的代码演示阶段,跟着敲一篇,简单的一批。
Application和Documents接口演示
Applicatioin和Documents是两个入门级API,前者控制客户端,后者保存着所有的文档对象
from win32com.client import Dispatch # 此乃调度器 client = Dispatch('kwps.Application') # 如果要启动微软的word客户端可使用下方办法 # client = Dispatch('word.Application') client.Visible = True # 到这,客户端已经能启动了,但尚未打开文档 # client是一个客户端对象,即Application对象 # Documents是Application的直接子级API,通过Application直接调用Documents # 创建一个新文档并返回一个Document对象 d1 = client.Documents.Add() # 有默认参数,正常创建无需传参 # 打开一个文档并返回一个Document对象 d2 = client.Documents.Open( FileName=file_name, ) # Open方法的参数多达15个,第一个参数是需要打开的文档路径,必填参数,文件不存在时抛出异常 # 如果文档要密码才能打开则使用需要将密码传给Open,如下 d2 = client.Documents.Open( FileName=file_path, # 文件路径 ConfirmConversions=True, # 文件不是word格式时是否会弹窗要求强制转换格式 ReadOnly=False, # 是否以只读方式打开 AddToRecentFiles=True, # 是否将文件添加到“文件”->"最近使用"中 PasswordDocument='密码' # 所需要的密码 ) # 注:Open还可以使用位置参数传参,其各个参数的位置要严格按照文档参数的位置来设置
此时,我们是不是已经有了两个文档对象了?一个Add
方法所创建的d1,一个是Open
方法所返回的d2。要想单独操作某个文档,就直接使用变量d1
或d2
去调用Document
接口中的方法和属性就OK了。
第一课的内容非常简单,其重点并非是Application和Documents如何使用,而是要建立起一个"用户思维",即再复杂的编程,最后都是给用户使用的,我们站在用户的角度的感受,该如何去操作一个文档:打开文档、操作文档,上方的变量中,d1
和d2
都是要操作的对象,围绕Document
这个对象,再去调用各种各样的接口来实现需求。
以上就是win32com操作word之Application&Documents接口学习的详细内容,更多关于win32com操作word接口的资料请关注脚本之家其它相关文章!