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

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

  • Стаття

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

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

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

Важливо

Опис

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

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

Важливо

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

Нотатка

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

Синтаксис

PDF(Назва екрана або елемента керування [,{Розмір, DPI, Поля, Орієнтація, Розгорнути контейнери}])

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

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

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

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

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

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

Приклади

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

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

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

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

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

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