函数参考


_WordDocSaveAs

保存指定的文档为一个新名称或者其它格式.

#include <Word.au3>
_WordDocSaveAs ( ByRef $o_object [, $s_FilePath = "" [, $i_Format = 0 [, $b_ReadOnlyRecommended = 0 [, $b_AddToRecentFiles = 0 [, $b_LockComments = 0 [, $s_Password = "" [, $s_WritePassword = ""]]]]]]] )

参数

$o_object Word.Application 对象变量的文档对象
$s_FilePath [可选参数] 用于保存文档的完整文件路径. (见备注)
"" = (默认) 如果该文档从未被保存,则使用默认的名称 (例如, Doc1.doc)
$i_Format [可选参数] 文档保存格式.
0 = (默认) Microsoft Word 格式
1 = 微软 Word 模板格式
2 = Microsoft Windows 文本格式
3 = 微软 Windows 换行的文本格式
4 = Microsoft DOS 文本格式
5 = 微软 DOS 文本换行符
6 = 富文本格式 (RTF)
7 = Unicode 文本格式或编码文本格式
8 = 标准 HTML 格式
9 = Web 存档格式
10 = 筛选的 HTML 格式
11 = 可扩展标记语言(XML)格式
$b_ReadOnlyRecommended [可选参数] 指定 Microsoft Word 被打开时是否为建议只读状态.
0 = (默认) 不建议只读
1 = 建议只读
$b_AddToRecentFiles [可选参数] 指定是否在文件菜单底部"最近使用的文件列表"添加打开的文件名.
0 = (默认) 不添加
1 = 添加
$b_LockComments [可选参数] 指定是否锁定文档的注释.
0 = (默认) 不锁定文档的注释
1 = 锁定文档的注释
$s_Password [可选参数] 打开文档的密码字符串. (见备注)
$s_WritePassword [可选参数] 保存文档更改的密码字符串. (见备注)

返回值

成功: 返回 1
失败: 返回 0, 并设置s @ERROR
@Error: $_WordStatus_Success = 没有错误
$_WordStatus_GeneralError = 一般错误
$_WordStatus_InvalidDataType = 无效的数据类型
$_WordStatus_InvalidObjectType = 无效的对象类型
@Extended: 包含无效的参数数目

注意/说明

 如果指定的文件名的文件已经存在, 该文件被覆盖并且不提示用户.
 如果该文件不能保存时脚本将会停止,除非 WordErrorHandler 已经注册.

 避免在您的应用程序中使用硬编码的密码. 如果是程序需要密码,将用户密码存储在一个变量中,然后在代码中使用该变量.

相关

_WordDocAdd, _WordDocClose, _WordDocOpen, _WordDocSave

示例/演示


; *******************************************************
; 示例 1 - 创建一个新的Microsoft Word文件并打开,追加一些文本,
;               执行另存为操作, 然后退出.
; *******************************************************
;
#include <Word.au3>

Local $oWordApp = _WordCreate()
Local $oDoc = _WordDocGetCollection($oWordApp, 0)

Sleep(3500);延迟以便观察变化
$oDoc.Range.Text = "这是追加的文本内容."
Sleep(3500);延迟以便观察变化

_WordDocSaveAs($oDoc, @ScriptDir & "\Test.doc")
_WordQuit($oWordApp)