次の方法で共有


PDF function (experimental)

適用対象: キャンバス アプリ

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

複数のシナリオで使用するために、現在の画面からオブジェクトにコンテンツをエクスポートします。

重要

説明設定

PDF関数を使用すると、PDF オブジェクト (BLOB) にエクスポートする画面または画面の一部を選択できます。

構成オプションが異なると、生成される PDFに対して異なる結果が得られます。

重要

  • PDF の生成は、アプリが実行されているデバイスで発生します。 PDFを生成する場合、デスクトップ コンピューターやモバイル デバイスなどのデバイスによって容量が異なります。
  • ファイル サイズが非常に大きい PDF を生成すると、アプリがクラッシュする可能性があります。 これは、アプリを実行しているデバイスの容量によって異なります。 画像のサイズと数、生成された PDFに含めるデータの量 (特にモバイル デバイスで使用するアプリ用) に注意してください。

Note

  • PDF関数を呼び出した画面に存在するコンテンツからのみ、PDFを生成できます。 たとえば、画面 2 に PDF 機能を追加した場合、生成された PDFには画面 2 のコンテンツのみを含めることができます。

構文

PDF (画面またはコントロール名 [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • 画面またはコントロール名 – 必須。 PDFの生成に使用するコンテンツを含む画面またはコントロール。 サポートされているコントロール: Vertical Gallery、Vertical Layout Container、Horizontal Layout Container、Container、Screen。

  • サイズ – オプション。 生成された PDFの寸法を制御します。 デフォルト値は、アプリ ユーザーのロケールによって異なります。米国およびカナダの場合はレター、その他のロケールの場合は A4。

  • DPI – オプション。 生成された PDFのスケーリング/解像度を制御します。 0 より大きい値である必要があります 指定されたマージンによって許可されたスペースを超えるコンテンツは、より高い実効 DPI になる可能性があります。 既定値は 96 です。

  • 余白 – オプション。 コンテンツと生成された PDFの外側の端の間に予約されている領域のサイズを指定する文字列。 生成された PDF の各余白 (上、右、下、左) は、異なる値をサポートできます。 この値でサポートされている測定単位には、in、cm、mm、pt、px が含まれます。 すべての余白のデフォルト値は 0.5 インチ (12.7 mm) です。

  • 方向 – オプション。 生成された PDF の向きを縦 (垂直) または横 (水平方向) にするかどうかを制御します。 既定値は縦です (垂直)。

  • ExpandContainers – オプション。 ブール値。 割り当てられたサイズを超えるコンテンツを持つ特定のコンテナーを展開して、生成された PDF内のすべてのコンテンツを表示するかどうかを制御します。 影響を受けるコントロールには、スクリーン、コンテナー、垂直および水平コンテナー、垂直固定高ギャラリー (ネストされていない)、フォーム、およびスクロール可能なキャンバス コントロールが含まれます。 既定値は False です。

使用例

プロパティ 結果
PDF(Screen1) 既定の設定で PDF オブジェクトを生成します。 PDF オブジェクトは、Screen1 の表示コンテンツから作成されます。
PDF(Container1、{Size: "A3"}) 用紙サイズが A3 に設定された PDF オブジェクトを生成します。 A3 サイズの PDF オブジェクトは、Container1 の表示コンテンツから作成されます。
PDF(Screen1、{DPI: 72、Margin: "25mm"、Orientation: "Landscape"}) 解像度 (DPI) が 72、余白が 25 ミリメートル、向きが横 (水平) に設定された PDF オブジェクトを生成します。 指定した DPI、余白、および向きの PDF は、Screen1 で表示されるコンテンツの既定のサイズ (ロケールに依存) で作成されます。
PDF(Screen1、{ExpandContainers: true}) 適用可能なコントロールが展開された PDF オブジェクトを生成します。 PDFが作成され、表示されるコンテンツよりも多くのコンテンツを持つコンテナー/ギャラリーが展開され、生成されたPDF内のすべてのコンテンツが表示されます。

既知の制限

  • 特定のコントロールは現在 ではサポートされていません。 これらには、グラフ、Power BI タイル、マップ、サードパーティ PCF コントロールの一部の構成が含まれます。

  • ネストされたギャラリーはサポートされていません。

  • 一部のフォントでは、生成された PDF に、ラテン以外のスクリプトの種類、フォントの太さ、太字や斜体などのスタイルが表示されない場合があります。

  • 入力可能な PDF の作成はサポートされていません。