共用方式為

PDF 函式 (實驗性)

  • 發行項

適用於： 畫布應用程式 模型導向應用程式

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

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

重要

描述

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

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

重要

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

Note

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

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

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

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

範例

公式 描述 結果
PDF(Screen1) 以預設設定產生 PDF 物件。 從 Screen1 的可見內容建立 PDF 物件。
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 中的所有內容。

已知限制

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

  • 不支援巢狀程式庫。

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

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