Функция _WordDocSaveAs

_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	[необязательный] Полный путь к файлу для сохранения документа. (См. Примечания) "" = (по умолчанию) если документ не был сохранен ни разу, то используется имя по умолчанию (например, Document1.doc)
$i_Format	[необязательный] Формат, в котором документ будет сохранен. 0 = (по умолчанию) Формат Microsoft Word 1 = Формат Microsoft Word Template 2 = Формат Microsoft Windows text 3 = Формат Microsoft Windows text с сохранением переносов строк 4 = Формат Microsoft DOS text 5 = Формат Microsoft DOS text с сохранением переносов строк 6 = Формат Rich text format (RTF) 7 = Текстовый формат в Юникоде или текстовый формат в кодировке 8 = Формат стандартного HTML 9 = Формат веб-архива 10 = Filtered HTML format 11 = Формат XML (Extensible Markup Language)
$b_ReadOnlyRecommended	[необязательный] Указывает, предлагать ли открыть документ в режиме "Только для чтения", всякий раз при открытии документа. 0 = (по умолчанию) Не предлагать режим "Только для чтения" 1 = Предлагать режим "Только для чтения"
$b_AddToRecentFiles	[необязательный] Указывает добавить ли имя файла в список недавно использованных файлов в нижней части меню Файл. 0 = (по умолчанию) Не добавлять 1 = Добавить
$b_LockComments	[необязательный] Указывает, блокировать ли документ для комментариев. 0 = (по умолчанию) Не блокировать комментарии 1 = Блокировать комментарии
$s_Password	[необязательный] Пароль на открытие документа.. (См. Примечания)
$s_WritePassword	[необязательный] Пароль для сохранения изменений в документе. (См. Примечания)

Возвращаемое значение

Успех:	Возвращает 1
Ошибка:	Возвращает 0 и устанавливает @error
@error:	$_WordStatus_Success = Нет ошибок
	$_WordStatus_GeneralError = Общая ошибка
	$_WordStatus_InvalidDataType = Неверный тип данных
	$_WordStatus_InvalidObjectType = Неверный тип объекта
@extended:	Содержит номер неисправного параметра

Примечания

Если документ с указанным именем файла уже существует, то он перезаписывается без первоначального запроса у пользователя.
If the file cannot be saved the script will be stop unless WordErrorHandler has been registered.

Избегайте использования жестко-заданных паролей в своих приложениях. Если пароль необходим процедуре, то запросите пароль у пользователя, сохраните его в переменную и затем используйте эту переменную в вашем коде.

См. также

_WordDocAdd, _WordDocClose, _WordDocOpen, _WordDocSave

Пример

; *******************************************************
; Пример 1 - Create a word window with a new blank document, add some text,
; execute a saveas operation, then quit.
; *******************************************************

#include <Word.au3>
$oWordApp = _WordCreate ()
$oDoc = _WordDocGetCollection ($oWordApp, 0)
$oDoc.Range.Text = "This is some text to insert."
_WordDocSaveAs ($oDoc, @ScriptDir & "\Test.doc")
_WordQuit ($oWordApp)