↑  ←  Описание функции


_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)