PDF 関数 (実験的)
適用先:
キャンバス アプリ モデル駆動型アプリ
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
複数のシナリオで使用するために、現在の画面からオブジェクトにコンテンツをエクスポートします。
重要
- これは試験段階の機能です。
- 実験段階の機能は運用環境での使用を想定しておらず、機能が制限されている場合があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。 詳細: キャンバス アプリで実験的、プレビューおよび廃止された機能を理解する
- この記事で説明する動作は、設定 > 今後の機能 > 実験段階 の PDF 機能の実験機能がオンの時のみ利用可能です (既定ではオフ)。
- お客様のフィードバックは弊社にとって重要です。 ご意見を Power Apps 実験的機能のコミュニティ フォーラム にお寄せください。
説明設定
PDF 機能を使用すると、画面または画面の一部を選択して、PDF オブジェクト (blob) にエクスポートできます。
構成オプションが異なれば、結果として生成される PDF の結果も異なります。
重要
- PDF の生成は、アプリが実行されているデバイスで行われます。 デスクトップ コンピューターやモバイル デバイスなどのデバイスが異なれば、PDF を生成するときの容量も異なります。
- ファイル サイズが非常に大きい PDF を生成すると、アプリがクラッシュする可能性があります。 これは、アプリを実行しているデバイスの容量によって異なります。 特に、モバイル デバイスでの使用を目的としたアプリの場合、生成された PDF に含める画像のサイズと数、およびデータの量に注意してください。
Note
- PDF 機能を呼び出した画面に存在するコンテンツからのみ PDF を生成できます。 たとえば、スクリーン 2 に PDF 機能を追加した場合、生成された PDF にはスクリーン 2 のコンテンツのみを含めることができます。
構文
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 の寸法を制御します。 デフォルト値は、アプリ ユーザーのロケールによって異なります。米国およびカナダの場合はレター、その他のロケールの場合は A4。
DPI – オプション。 生成された PDF のスケーリング/解決策を制御します。 0 より大きい値である必要があります 指定されたマージンによって許可されたスペースを超えるコンテンツは、より高い実効 DPI になる可能性があります。 既定値は 96 です。
Margin – オプション。 コンテンツと生成された PDF の外縁との間に確保されるスペースのサイズを指定する文字列。 生成された PDF の各余白 (上、右、下、左) は、異なる値をサポートできます。 この値でサポートされている測定単位には、in、cm、mm、pt、px が含まれます。 すべての余白のデフォルト値は 0.5 インチ (12.7 mm) です。
Orientation – オプション。 生成された 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 オブジェクトを生成します。 | 指定された DPI、余白、方向を持つ PDF が、Screen1 の表示コンテンツからデフォルト サイズ (ロケールに依存) で作成されます。 |
| PDF(Screen1, {ExpandContainers: true}) | 該当するコントロールが展開された PDF オブジェクトを生成します。 | 表示されているよりも多くのコンテンツを含むコンテナー/ギャラリーが展開され、生成された PDF 内のすべてのコンテンツが表示される PDF が作成されます。 |
既知の制限
特定のコントロールは現在 ではサポートされていません。 これらには、グラフ、Power BI タイル、マップ、サードパーティ PCF コントロールの一部の構成が含まれます。
ネストされたギャラリーはサポートされていません。
一部のフォントでは、生成された PDF に太字や斜体などのラテン語以外のスクリプト タイプとフォントの太さとスタイルが表示されない場合があります。
入力可能な PDF の作成はサポートされていません。