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

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

  • Статья

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Экспорт содержимого с текущего экрана в объект для использования в нескольких сценариях.

Внимание

Description

Функция PDF позволяет выбрать экран или части экрана для экспорта в объект PDF (BLOB-объект).

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

Внимание

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

Заметка

  • Вы можете создать PDF-файл только из содержимого, существующего на экране, где вы вызвали функцию PDF. Например, если вы добавили функцию PDF на второй экран, то только содержимое второго экрана может быть включено в сгенерированный PDF-файл.

Синтаксис

PDF(Имя экрана или элемента управления [,{Размер, DPI, Поле, Ориентация, ExpandContainers}])

  • Имя экрана или элемента управления – Обязательно. Экран или элемент управления, содержащий содержимое, используемое для создания PDF-файла. Поддерживаемые элементы управления: Vertical Gallery, Vertical Layout Container, Horizontal Layout Container, Container, Screen.

  • Размер – Необязательно. Управляет размерами сгенерированного PDF-файла. Значение по умолчанию зависит от языкового стандарта пользователя приложения; Letter для США и Канады и A4 для других регионов.

  • DPI – Необязательно. Управляет масштабированием/разрешением сгенерированного PDF-файла. Должно быть значением, большим 0. Содержимое, превышающее пространство, разрешенное указанными полями, может привести к более высокому эффективному DPI. Значение по умолчанию равно 96.

  • Поле – Необязательно. Строка, указывающая размер пространства, зарезервированного между содержимым и внешним краем сгенерированного PDF-файла. Каждое поле сгенерированного PDF-файла (верхнее, правое, нижнее, левое) может поддерживать разные значения. Поддерживаемые единицы измерения для этого значения включают дюймы, см, мм, пункты и пиксели. Значение по умолчанию — 0,5 дюйма (12,7 мм) для всех полей.

  • Ориентация – Необязательно. Определяет, будет ли сгенерированный PDF-файл иметь книжную (вертикальную) или альбомную (горизонтальную) ориентацию. По умолчанию используется портретная (вертикальная).

  • ExpandContainers – Необязательно. Логическое значение. Определяет, будут ли определенные контейнеры с содержимым, превышающим выделенный им размер, расширяться для отображения всего содержимого в сгенерированном PDF-файле. Затронутые элементы управления включают экраны, контейнеры, вертикальные и горизонтальные контейнеры, вертикальные галереи фиксированной высоты (не вложенные), формы и прокручиваемые элементы управления холстом. По умолчанию используется значение false.

Примеры

Формула Описание Результат
PDF(Экран1) Создает объект PDF с настройками по умолчанию. Объект PDF создается из видимого содержимого экрана Screen1.
PDF(Контейнер1, {Размер: A3}) Создает объект PDF с размером бумаги A3. Объект PDF формата A3 создается из видимого содержимого элемента управления Container1.
PDF(Экран1, {DPI: 72, Поля: "25 мм", Ориентация: "Альбомная"}) Создает объект PDF с разрешением (DPI) 72, полем 25 миллиметров и альбомной (горизонтальной) ориентацией. PDF-файл с заданным разрешением, полем и ориентацией создается с размером по умолчанию (в зависимости от языкового стандарта) из видимого содержимого на экране Screen1.
PDF(Screen1, {ExpandContainers: true}) Создает объект PDF с развернутыми применимыми элементами управления. Создается PDF-файл, в котором любые контейнеры/галереи с большим объемом содержимого, чем видно, расширяются для отображения всего содержимого в сгенерированном PDF-файле.

Известные ограничения

  • Некоторые элементы управления не поддерживаются в настоящее время. К ним относятся графики, плитка Power BI, карта и некоторые конфигурации элементов управления PCF сторонних производителей.

  • Вложенные галереи не поддерживаются.

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

  • Создание заполняемых PDF-файлов не поддерживается.