PDF 函数（试验性的）

适用于：画布应用模型驱动应用

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

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

重要提示

说明

PDF 函数允许您选择屏幕或屏幕的一部分来导出到 PDF 对象 (blob)。

不同的配置选项支持生成的 PDF 有不同的结果。

重要提示

PDF 生成发生在运行应用的设备上。生成 PDF 时，不同的设备（如台式计算机和移动设备）将具有不同的容量。
生成文件大小非常大的 PDF 可能会导致应用崩溃。这取决于运行应用的设备的容量。注意图像的大小和数量，以及您希望在生成的 PDF 中包含多少数据，特别是对要在移动设备上使用的应用。

备注

PDF(Screen or control name [,{Size, DPI, Margin, Orientation, ExpandContainers}])

Screen or control name – 必需。包含用于生成 PDF 的内容的屏幕或控件。支持的控件：Vertical Gallery、Vertical Layout Container、Horizontal Layout Container、Container、Screen。
Size – 可选。控制生成的 PDF 的维度。默认值取决于应用用户的区域设置；美国和加拿大为 Letter，其他地区为 A4。
DPI – 可选。控制生成的 PDF 的缩放/分辨率。必须是大于 0 的值。超过指定边距允许的空间的内容可能会导致有效 DPI 提高。默认值为 96。
Margin – 可选。一个字符串，指定内容和生成的 PDF 外边缘之间保留的空间大小。生成的 PDF 的各个边距（顶部、右侧、底部、左侧）可以支持不同的值。此值支持的度量单位包括 in、cm、mm、pt 和 px。所有边距的默认值为 0.5 inch (12.7 mm)。
Orientation – 可选。控制生成的 PDF 是纵向（垂直）还是横向（水平）。默认值为 portrait (vertical)。
ExpandContainers – 可选。布尔。控制内容超过分配大小的某些容器是否展开以在生成的 PDF 中显示所有内容。受影响的控件包括 screens、containers、vertical containers 和 horizontal containers、vertical fixed-height galleries（非嵌套）、forms 和 scrollable canvas 控件。默认值为 false。

公式	说明	结果
PDF(Screen1)	使用默认设置生成 PDF 对象。	PDF 对象从 Screen1 的可见内容创建。
PDF(Container1, {Size: A3})	生成将纸张大小设置为 A3 的 PDF 对象。	从 Container1 的可见内容创建 A3 大小的 PDF 对象。
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"})	生成分辨率 (DPI) 设置为 72、边距设置为 25 毫米、方向设置为横向（水平）的 PDF 对象。	从 Screen1 上的可见内容以默认大小（取决于区域设置）创建具有指定 DPI、边距和方向的 PDF。
PDF(Screen1, {ExpandContainers: true})	生成展开适用控件的 PDF 对象。	创建任何内容超过可见内容的容器/库将展开，以在生成的 PDF 中显示所有内容的 PDF。