共用方式為


PDF 函式 (實驗性)

適用於: 畫布應用 模型驅動應用

[本文章是發行前版本文件,隨時可能變更。]

將目前畫面中的內容匯出至物件,以便在多個案例中使用。

重要

描述

PDF 功能可讓您選取一個畫面或部分畫面以匯出至 PDF 物件 (blob)。

不同的設定選項為產生的 PDF 提供不同的結果。

重要

  • PDF 產生發生在執行應用程式的裝置上。 當您產生 PDF 時,不同的裝置 (例如桌上型電腦和行動裝置) 將會有不同的容量。
  • 產生具有極大檔案大小的 PDF 可能會造成應用程式崩潰。 這要視您在執行應用程式的裝置容量而定。 請注意影像的大小和數目,以及您想要在產生的 PDF 中包含的資料量,特別是要用於行動裝置的應用程式。

Note

  • 您只能從叫用 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。

  • margin (邊距)– 可選。 字串,指定在內容和產生 PDF 的外部邊緣之間保留的空間大小。 產生 PDF 的每個邊界 (上、右、下、左) 都可以支援不同的值。 此值支援的度量單位包括 in、cm、mm、pt 和 px。。 所有邊界的預設值都是 0.5 英吋 (12.7 公釐)。

  • 方向– 可選。 控制產生的 PDF 是直向 (垂直) 還是橫向 (水平) 方向。 預設值為直向 (垂直)。

  • ExpandContainers– 可選。 布林值。 控制內容超過其配置大小的特定容器是否會展開來顯示所產生 PDF 中的所有內容。 受影響的控制項包括畫面、容器、垂直及水準容器、垂直固定高度程式庫 (非巢狀)、表單和可捲動的畫布控制項。 預設值為 False。

範例

公式 描述 結果
PDF(螢幕 1) 以預設設定產生 PDF 物件。 從 Screen1 的可見內容建立 PDF 物件。
PDF 檔(Container1,Size {:A3}) 產生頁面大小設定為 A3 的 PDF 物件。 從 Container1 的可見內容建立 A3 大小的 PDF 物件。
PDF(螢幕 1,DPI {:72,邊距:“25mm”,方向:“橫向”)} 產生解析度 (DPI) 設定為 72、邊界設定為 25 毫米和方向設定為橫向 (水平) 的 PDF 物件。 從 Screen1 上的可見內容以預設大小 (取決於地區設定) 建立具有指定 DPI、邊界和方向的 PDF。
PDF(Screen1,ExpandContainers {:true}) 產生展開適當控制項的 PDF 物件。 建立一個 PDF,其中內容超過可見內容的容器/程式庫會展開,以顯示產生 PDF 中的所有內容。

已知限制

  • 目前不支援特定控制項。 其中包括圖表、Power BI 圖標、地圖和協力廠商 PCF 控制項的部分設定。

  • 不支援巢狀程式庫。

  • 對於某些字體,非拉丁指令碼類型和字體粗細和樣式 (例如粗體和斜體) 可能不會出現在產生的 PDF 中。

  • 不支援建立可填入的 Pdf。