bool SaveFile(nType, sPath, sParams);
Сохраняет файл после внесения всех изменений. Необходимо задать тип сохраняемого файла.
Параметры:
| Название | Тип | Описание |
| nType | int | Тип сохраняемого файла задается как шестнадцатеричное целое число для кода .Net. Для файла сценария .docconstructor возможны следующие значения: docx, odt, rtf, txt, pptx, xlsx, ods, csv, pdf (см. значения AVS_OFFICESTUDIO_FILE_XXX). |
| sPath | String^ | Путь к сохраняемому файлу вместе с его именем и расширением. |
| sParams | String^ | Параметры, необходимые для корректного сохранения файла (чаще всего используется кодировка для типов файлов txt и csv или разделитель для файлов csv, для других типов файлов это просто пустая строка). Параметры добавляются в виде тегов XML, где m_nCsvTxtEncoding используется для кодирования текста, а m_nCsvDelimiter — для разделителя csv. Поддерживаемые значения разделителей csv включают:
При сохранении в файл изображения (png или jpg) для создания миниатюр используются дополнительные параметры. Смотрите ниже, чтобы узнать их. |
Пример
.Net
string workDirectory = "C:/Program Files/Р7/DocumentBuilder";
string resultPath = "result.docx";
var doctype = (int)OfficeFileTypes.Document.DOCX;
CDocBuilder.Initialize(workDirectory);
CDocBuilder oBuilder = new CDocBuilder();
oBuilder.SaveFile(doctype, resultPath);
CDocBuilder.Destroy();
.docconstructor
builder.SaveFile("docx", "result.docx");
Сохранение в изображениях
Конструктор документов позволяет сохранять файлы документов в файлы изображений, создавая эскизы первой страницы или всех страниц документа. Это делается с помощью параметров метода SaveFile(). Параметры добавляются в виде тегов XML, где можно использовать следующие теги:
- m_oThumbnail — тег core, показывающий, что внутренние узлы будут использоваться для создания миниатюры из файла документа;
- format -формат файла изображения, используемый для создания миниатюры (может иметь следующие значения: 3 — для файла JPG, 4 — для файла PNG);
- aspect — соотношение сторон изображения при создании миниатюры из файла документа (может принимать следующие значения: 1 — сохранится исходное соотношение сторон, 0 — изображение растянется по ширине и высоте, указанным ниже;
- first — следует ли конвертировать в эскиз только первую страницу или все страницы (может иметь следующие значения: true — будет преобразована только первая страница, false — все страницы документа будут использованы для создания эскизов, в этом случае файл будет сохранен как архив изображений, по одному на каждую страницу);
- width -ширина изображения в пикселях.
- height — высота изображения в пикселях.
Пример
.Net
oBuilder.SaveFile(OFFICESTUDIO_FILE_IMAGE, "thumbnail.png", "<m_oThumbnail><format>4</format><aspect>1</aspect><first>false</first><width>1000</width><height>1000</height></m_oThumbnail>");
.docconstructor пример с преобразованием только первой страницы
builder.SaveFile("image", "./thumbnail.png", "<m_oThumbnail><format>4</format><aspect>1</aspect><first>true</first><width>1000</width><height>1000</height></m_oThumbnail>");.docconstructor пример с преобразованием всех страниц и на выходе получим архив
builder.SaveFile("image", "./thumbnail.zip", "<m_oThumbnail><format>4</format><aspect>1</aspect><first>false</first><width>1000</width><height>1000</height></m_oThumbnail>");