PDF 函数(实验性)

适用于: 画布应用

[本文为预发布文档,可能会发生变化。]

将内容从当前屏幕导出到对象,以在多个场景中使用。

重要提示

说明

该 PDF 函数允许你选择用于导出到 PDF 对象(blob)的屏幕或屏幕部分。

不同的配置选项为生成的 PDF结果启用不同的结果。

重要提示

  • PDF 生成发生在运行应用的设备上。 生成 PDF设备时,台式计算机和移动设备等不同设备将具有不同的容量。
  • PDF生成大小异常大的文件大小可能会导致应用崩溃。 这取决于运行应用的设备的容量。 请注意图像的大小和数量以及要在生成的 PDF数据中包括的数据量,特别是适用于在移动设备上使用的应用。

备注

  • 只能从已调用PDF函数的屏幕上现有的内容生成PDF内容。 例如,如果在第二个屏幕上添加了 PDF 函数,则生成的第二个屏幕中只能包含 PDF内容。

语法

PDF (屏幕或控件名称 [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • 屏幕或控件名称– 必需。 包含要用于生成内容的 PDF屏幕或控件。 支持的控件:Vertical Gallery、Vertical Layout Container、Horizontal Layout Container、Container、Screen。

  • 大小– 可选。 控制生成的 PDF维度。 默认值取决于应用用户的区域设置;美国和加拿大为 Letter,其他地区为 A4。

  • DPI –可选。 控制生成的 PDF缩放/分辨率。 必须是大于 0 的值。 超过指定边距允许的空间的内容可能会导致有效 DPI 提高。 默认值为 96。

  • margin(边距)– 可选。 一个字符串,指定在内容和生成的 PDF外边缘之间保留的空间大小。 生成的 PDF 每个边距(上、右、下、左)都可以支持不同的值。 此值支持的度量单位包括 in、cm、mm、pt 和 px。 所有边距的默认值为 0.5 inch (12.7 mm)。

  • 方向– 可选。 控制生成的 PDF 是纵向(垂直)还是横向(水平)方向。 默认值为 portrait (vertical)。

  • ExpandContainers– 可选。 布尔。 控制具有超出其分配大小的内容的某些容器是否展开以显示生成的 PDF所有内容。 受影响的控件包括 screens、containers、vertical containers 和 horizontal containers、vertical fixed-height galleries(非嵌套)、forms 和 scrollable canvas 控件。 默认值为 false。

示例

公式 描述 结果
PDF(屏幕 1) PDF生成具有默认设置的对象。 对象 PDF 是从 Screen1 的可见内容创建的。
PDF(Container1、 {Size: “A3”}) 生成一个 PDF 将纸张大小设置为 A3 的对象。 A3 大小的 PDF 对象是从 Container1 的可见内容创建的。
PDF(Screen1, {DPI: 72, Margin: “25mm”, Orientation: “Landscape”}) PDF生成分辨率(DPI)设置为 72 的对象,边距设置为 25 毫米,方向设置为横向(水平)。 具有指定 DPI、边距和方向的 A PDF 是在屏幕 1 上可见内容的默认大小(依赖于区域设置)创建的。
PDF(Screen1,{ExpandContainers: true}) 生成 PDF 扩展了适用控件的对象。 创建一个 PDF 容器/库,其中显示的内容超过可见的任何容器/库将展开以显示生成的 PDF所有内容。

已知限制

  • 某些控件当前不受支持。 其中包括图表、Power BI 磁贴、地图和第三方 PCF 控件的一些配置。

  • 不支持嵌套库。

  • 非拉丁文脚本类型和字体粗细以及粗体和斜体等样式可能不会出现在为某些字体生成的 PDF 样式中。

  • 不支持创建可填充的 PDF。