Power Apps PDFビューアー（試験段階）の使い方色々｜Zoom、FineNext、OnStateChangeなどなど

試験段階ということもあって今まであまり使ってこなかったPDFビューアー。

Power AppsでPDFを表示する必要がでて色々と遊んでみたので、その結果をメモ。

PDFビューアー（試験段階）

PDFビューアーはその名の通りPDFファイルを表示するコントロールで、残念ながらまだ試験段階。

そのためか、↓の公式にあるプロパティが実際には存在しないこともある（OnSelectとか）。
https://docs.microsoft.com/ja-jp/powerapps/maker/canvas-apps/controls/control-pdf-viewer

表示するPDFの指定方法

公式には「PDFビューアーに表示するPDFはURLで設定する」と書かれている。

しかし、実際にURLを指定する場合、

• HTTPSであること
• URLの先が認証不要なサーバーであること

といった制限があったりするので、いまいち使い勝手がよくない印象。

認証不要なサーバー上にあるPDFが対象なので、SharePointやOneDriveのドキュメントは普通にURL指定しても表示できない。。。

そこでPDFを指定する場合は以下の手段を取ることになるかと。

SharePoint Online ドキュメントライブラリからデータを引っ張ってくる

SharePoint OnlineのドキュメントライブラリにあるPDFのデータをPowerAutomateで取得して表示する方法。

こちらのサイトでご紹介いただいている方法。

SharePoint ドキュメントライブラリのPDFを #PowerApps で表示する - Qiita

はじめに本投稿は Brian Edwardsさんの投稿を応用した手法の紹介です。オリジナルの投稿は…

qiita.com

メディアとして追加

画像ファイルのようにPower AppsのメディアとしてPDFを埋め込む方法。

こちらのサイトでご紹介いただいている方法。

Power Apps の PDF Viewer でアプリ埋め込みファイルを表示したい | 株式会社イルミネート・ジャパン

Power Apps アプリで PDF ビューアー コントロールを利用する際の設定や制限事項は以下が参考になりますが、

www.illuminate-j.jp

Base64データ

PDFをBase64形式のデータに変換し、直接PDFビューアーに埋め込む方法。

詳細はこちらに書いてあるので、興味のある方はぜひ。

Power Apps PDFをキャンバスアプリにBase64で直接埋め込む｜PDFビューアーの使い方

Power Appsは、画像コントロールとかを含めてBase64のデータに対応していることが多いイメージ。 そこで、ひょっとしたらPDFも？みたいな感じで試してみた。 PDFビューアー(試験段階) PDFビューアーは試験段階の機能で、Pow...

ippu-biz.com

2021.04.29

PDFビューアーのプロパティたち

PDFビューアーには色々なプロパティがあって、正直使い方がわかりにくいものもいくつかｗ

今回はそのプロパティを色々いじってみたのでその内容をご紹介。

※PDFビューアーは試験段階の機能なので、ここの内容が急に変わることもあります。

Document

Documentプロパティは表示するPDFを指定するプロパティ。

基本はダブルクォーテーション（””）で囲ったURLを指定するが、PDFをメディアとして追加する場合はそのメディア名を、Base64で埋め込む場合はそのデータをダブルクォーテーションで囲って指定する。

Base64データのときはこんな感じ。

ShowControls

ShowControlsプロパティをtrueにすると、標準で用意されているPDFの操作機能が表示される。

Zoom, ActualZoom(読み取り専用)

Zoomプロパティはその名前の通り、拡大／縮小率を指定するプロパティ。

例えば200とか設定すると、拡大率200%で表示されるし、

Fit系のEnum値を設定すると画面に合わせて表示される。

なのでこんな感じでスライダーとかと合わせて使うと便利かもしれない。

ActualZoomプロパティは実際の拡大率を返してくれるプロパティで、Zoomプロパティに数値をいれたときはその値を、Fit系のEnumを入れると実際の拡大率の値を返してくれる。

※ちなみにZoomプロパティには0も指定できるんだけど、拡大率0ってどういうことだろｗ

Page, PageCount(読み取り専用), CurrentPage(読み取り専用)

Pageプロパティを使用すると、表示するページをこちら側で指定することができる。

こんな感じで2を指定すると2ページ目が表示される。

PageCountはドキュメントの最大ページ数を返してくれるので、こんな感じでスライダーのMax値に設定して、

こんな感じでPageプロパティを設定すれば、スライダーと連動も可能。

ちなみに「Pageプロパティを設定するとビューアーのページは動く」けど、「ビューアーのページを動かしてもPageプロパティは動かない」ようになっている。

なので、ユーザーがスクロールバーとかを操作してページを移動してもPageプロパティの値は変化しないので、現在のページを参照したいときはCurrentPageプロパティを使う。

FindText

FindTextプロパティに値（文字列）を設定すると、PDFファイル内のテキストを検索してくれる。

こんな感じで直打ちすると先頭の文字を探してくれる。

基本的にはテキストボックスと併用することになるかなぁと。

ここまではまぁわかりやすいんだけど、使い方のクセが強めなのが次の「FindNext」と「FindPrevious」プロパティ。

FindNext, FindPrevious

FindNextプロパティとFindPreviousプロパティはその名前の通り、テキスト検索の次の（または前の）結果へと進むプロパティ。

だと思うんだけど、なぜか初期値が「false」というbool値。

で色々いじってみたところ、どうやらこのFindNext（FindPrevious）の値がtrueに変化するときに、次の（前の）検索結果へと移動するぽい。

なのでもし「次の検索結果へ」ボタンを実装するとしたらこんな感じになるのかなと。

こんな感じで変数を用意して、値を無理やり変化。

で、この変数をFineNextプロパティに入れる。

押してみると、次の検索結果へと移動する！

確かにPower Appsはコントロールの機能をコールすることはできないけど、使い方のクセが強いｗ

それか僕の使い方が間違っているかもしれないけれど、PDFビューアーの情報が少ないので何とも言えないｗ

OnStateChangeイベント

最後はPDFビューアーが持つ唯一のアクション「OnStateChange」。

名前からすると何かしらの状態が変わったときにコールされるんだろうけど、「何の状態が変わったときか？」がわからない。

なので、PDFビューアーをユーザーが操作したり、こちら側から操作したときはほぼすべてこの「OnStateChange」は呼び出される。

使うシチュエーションとしては、「最後のページまできちんと読んだか？」チェックとかが考えられるかなと。

OnStateChangeが呼ばれる度にコレクションとかにCurrentPageの値を重複無しで貯めていって、全ページ読めたら次の画面へと進めるようにする、みたいな感じ。

今回は触れなかったけどパスワード付きPDFも扱えるようなので、また機会があれば取り上げてみようかなぁと。