Поділитися через

Функція PDF (експериментальна)

  • Стаття

Застосовується до: програм Canvas Програм на основі моделі

[Ця стаття стосується інструкції до попередньої версії, і її буде змінено.]

Експортуйте вміст із поточного екрана до об’єкта для використання в кількох сценаріях.

Важливо

Опис

Функція PDF дає змогу вибрати екран або частини екрана для експорту в об’єкт PDF (BLOB-об’єкт).

Різні параметри конфігурації дають змогу отримати різні результати для кінцевого згенерованого PDF-файлу.

Важливо

  • Створення PDF-файлу відбувається на пристрої, де запущена програма. Під час створення PDF-файлу різні пристрої, як-от настільні комп’ютери та мобільні пристрої, можуть мати різні можливості.
  • Створення PDF-файлу надзвичайно великого розміру може спричинити аварійне завершення роботи програми. Це залежить від виробничої спроможності пристрою, на якому запущена програма. Пам’ятайте про розмір і кількість зображень, а також обсяг даних, які необхідно включити до згенерованого PDF-файлу, особливо для програм, призначених для використання на мобільному пристрої.

Нотатка

  • PDF-файл можна створити лише з вмісту, який відображається на екрані, де було викликано функцію PDF. Наприклад, якщо функцію PDF було додано на екрані 2, до згенерованого PDF-файлу можна додати лише вміст з екрану 2.

Синтаксис

PDF(Назва екрану або елемента керування [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Screen or control name – обов’язковий аргумент. Екран або елемент керування, який містить вміст для створення PDF-файлу. Підтримувані елементи керування: вертикальна галерея, контейнер вертикального макета, контейнер горизонтального макета, контейнер, екран.

  • Size – необов’язковий аргумент. Керує вимірами створеного PDF-файлу. Стандартне значення залежить від локалізації користувача програми; Letter для США й Канади та A4 для інших локалізацій.

  • DPI – необов’язковий аргумент. Керує масштабуванням і роздільною здатністю створеного PDF-файлу. Значення має бути більшим за 0. Якщо вміст перевищує простір, дозволений указаними полями, це може призвести до вищого ефективного значення DPI. Значення за замовчуванням: 96.

  • Margin – необов’язковий аргумент. Рядок, який визначає розмір простору, зарезервованого між вмістом і верхнім краєм створеного PDF-файлу. Кожне поле створеного PDF-файлу (зверху, праворуч, знизу, ліворуч) може підтримувати інше значення. Підтримувані одиниці вимірювання для цього значення охоплюють дюйми, см, мм, точки й пікселі. Стандартне значення для всіх полів: 12,7 см (0,5 дюйма).

  • Orientation – необов’язковий аргумент. Визначає орієнтацію створеного PDF-файлу: книжкова (вертикальна) чи альбомна (горизонтальна). Стандартне значення: книжкова (вертикальна).

  • ExpandContainers – необов’язковий аргумент. Логічне значення. Визначає, чи розгортатимуться певні контейнери з вмістом, який перевищує виділений розмір, для відображення всього вмісту створеного PDF-файлу. Зазначені елементи керування охоплюють екрани, контейнери, вертикальні та горизонтальні контейнери, вертикальні галереї із фіксованою висотою (не вкладені), форми та елементи керування полотном із можливістю прокручування. Значення за промовчанням "хибність".

Приклади

Формула Опис Результат
PDF(Screen1) Створює об’єкт PDF зі стандартними параметрами. Об’єкт PDF створюється на основі видимого вмісту Screen1.
PDF(Container1, {Size: A3}) Створює об’єкт PDF із розміром паперу, установленим на A3. Об’єкт PDF розміру A3 створюється на основі видимого вмісту Container1.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Створює об’єкт PDF із такими параметрами: роздільна здатність (DPI) 72, поля 25 міліметрів, а орієнтація альбомна (горизонтальна). PDF-файл із заданими значеннями DPI, полів і орієнтації створюється зі стандартним розміром (залежить від регіональних параметрів) з видимого вмісту на екрані Screen1.
PDF(Screen1, {ExpandContainers: true}) Створює об’єкт PDF із застосовними розгорнутими елементами керування. PDF-файл створюється, якщо будь-які контейнери або галереї із вмістом, більшим за відображуваний, розгортаються, щоб відобразити весь вміст створеного PDF-файлу.

Відомі обмеження

  • Певні елементи керування наразі не підтримуються. До них відносяться діаграми, плитка Power BI, карта та деякі конфігурації елементів керування сторонніх виробників PCF.

  • Вкладені галереї не підтримуються.

  • У створеному PDF-файлі для деяких шрифтів можуть не відображатися нелатинські типи шрифтів, а також насиченість і стилі шрифтів, як-от жирний і курсив.

  • Створення PDF-файлів, які можна заповнити, не підтримується.