ドキュメント ビューアー

[ドキュメント ビューアー] コントロールを使用すると、ドキュメントをレンダリングしてアプリ内でインライン表示できます。たとえば、ドキュメント ビューアーコントロールを使用して、ストレージ バケット、エンティティ、パブリック リンクなど、さまざまなソースに存在する請求書ドキュメントや領収書を表示できます。

[ドキュメント ビューアー] コントロールはローカル マシンのファイルをサポートしません。リモート ドキュメントの参照には、URL、ストレージ バケット、またはエンティティを使用する必要があります。

ファイルをアプリ変数に割り当てる際は、変数の型が IResource であることを確認してください。

画像を表示するだけでよい場合は、[画像] コントロールの使用をお勧めします。

重要:

ドキュメント ビューアーは組み込みの PDF.js ビューアーを使用します。PDF.js ビューアーはどのブラウザーでも一貫して動作します。ブラウザーの設定は不要です。外部ファイル サーバーから PDF を読み込む場合は、サーバーがクロス オリジン要求をサポートしている必要があります。CORS が有効化されていない場合、組み込みの PDF.js ビューアーはドキュメントを表示できません。

ストレージ バケットで [ドキュメント ビューアー] を使用する

アプリでストレージ バケットを使用する場合は、[ドキュメント ビューアー] コントロールの [ソース] プロパティを IResource 型変数にする必要があります。

1. [ストレージ バケットからファイルをダウンロード] ルールをアプリに追加します。
2. IResource 型変数を [ストレージ バケットからファイルをダウンロード] ルールにバインドします。
3. 同じ IResource 型変数を [ドキュメント ビューアー] の [ソース] プロパティにバインドします。

IResource を使用する

ファイルを ILocalResource として取得すると、ファイルは以下を使用して自動的に IResource に変換されます。

JobAttachment.fromResource(file) // file is a ILocalResource

重要:

以下の関数は非推奨となったため、使用しないでください。

• .toLocalResource
• .toAppsFile

ページ ナビゲーション

以下を使用して、ドキュメント ビューアー内の特定のページにプログラムによって移動できます。

appsFile.NavigateToPage(pageNumber)

全般

• ソース - 表示するドキュメントのソースです。サポートされているファイルのタイプは、PDF ドキュメントと画像 (JPEG、PNG、BMP、GIF、および WEBP) です。
• 非表示 - true の場合、実行時にコントロールが非表示になります。
• 無効化 - true の場合、実行時にコントロールを無効化します。

イベント

イベントはありません。

スタイル

• コントロールの配置 - 既定では、親の配置を継承します。親とは異なる配置を設定することもできます。既定の親の配置に戻すには、現在優先されているオプションの選択を解除します。
  注:

  配置は、親に対して選択したレイアウト (縦方向と横方向) によって異なります。

• 枠線 - コントロールの枠線です。枠線の太さ、色、半径を設定できます。
• マージン - コントロールのマージンです。既定では 4px のマージンが設定されています。[上/下] および [左/右] のプロパティがそれぞれ組み合わされています。これらのプロパティの組み合わせは、[マージン] セクションの右側にある [リンク] ボタンをクリックして解除できます。
• サイズ - コントロールの幅と高さです。既定では、サイズは [auto] (320 x 410px) に設定されています。最小値または最大値を設定するには、3 点リーダー メニューのアイコン (...) を選択します。

VB のプロパティ

VB のプロパティ	データ型	説明
Source	IResource	現在表示されているソース ファイルです。
Value	IResource	[ドキュメント ビューアー] コントロールから関連付けまたは出力される値です。
Hidden	Boolean	true の場合、実行時にコントロールが非表示になります。
Disabled	Boolean	true の場合、実行時にコントロールを無効化します。