editSheetPrintOptions

await crafttechApi.editSheetPrintOptions(fileHandler, sheetName, config);

Описание

Изменяет параметры печати листа.

Требует сохранения при помощи saveFile (для внешнего файла), либо applyActiveFileChanges (для активного файла).

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа;
• config (object) — объект с полями, которые необходимо поменять:
  • orientation (string) — ориентация листа (portrait, landscape);
  • zoom (number) — размер увеличения на листе;
  • fitToPage (boolean) — подгонка размера под содержимое (true или false);
  • marginLeft (number) — отступ слева;
  • marginRight (number) — отступ справа;
  • marginTop (number) — отступ сверху;
  • marginBottom (number) — отступ снизу;
  • horizontalCentered (number) — центровка по горизонтали (1 или 0);
  • paperSize (number) — размер бумаги (см. Размеры бумаги в Р7-Офис ниже).
  • printArea (string) — диапазон ячеек на листе, которые будут входить в область печати.

Размеры бумаги в Р7-Офис

Все размеры указаны в сантиметрах (см)

1. US Letter (21.59 x 27.94)
2. US Legal (21.59 x 35.56)
3. A4 (21 x 29.7)
4. A5 (14.8 x 21)
5. B5 (17.6 x 25)
6. Envelope 10 (10.48 x 24.13)
7. Envelope DL (11 x 22)
8. Tabloid (27.94 x 43.18)
9. A3 (29.7 x 42)
10. Tabloid Oversize (30.48 x 45.71)
11. ROC 16K (19.68 x 27.3)
12. Envelope Choukei 3 (11.99 x 23.49)
13. SuperB/A3 (33.02 x 48.25)

Возвращает

• true | false (boolean) — возвращает логическую истину true в случае успешного изменения параметров печати листа, иначе false.

Пример

const conf = {
  orientation: "portrait",
  zoom: 1.02,
  fitToPage: true,
  marginLeft: 0.77,
  marginRight: 0.77,
  marginTop: 1,
  marginBottom: 1,
  horizontalCentered: 1,
  paperSize: 5,
  printArea: "A1:B10",
};

const result = await crafttechApi.editSheetPrintOptions(
  fileHandler,
  "Лист1",
  conf
);
console.log("Параметры изменены: ", result);