• Post category:Класс CDocBuilder
  • Запись изменена:24.01.2024

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 включают:

  • 0 — без разделителя
  • 1 — табуляция
  • 2 — точка с запятой
  • 3 — двоеточие
  • 4 — запятая
  • 5 — пробел

При сохранении в файл изображения (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>");