[execDialog]AcrobatのJavascriptsダイアログ【最終回】

AcrobatのJavascriptsでダイアログ制御の最終回
今迄の経過は
ダイアログの概要[LINK]と
【その１】[LINK]【その２】[LINK]【その３】[LINK]【その４】[LINK]も参考にしてください
 

■起動時に実行させる
■レイヤ制御等
の２点でこのシリーズ？は終わりにします。

まずはファイルを

「LicenseBox.pdf」をダウンロード[PDF]

 
■起動時に実行させる

起動時にスクリプトを実行させるのは
ドキュメントレベルのスクリプトになります

文書レベルのJavascriptの編集から

新規に作って行きます

ファンクションに内容を記述して
ファンクションを呼び出す記述をすればOK

サンプルのPDFでは

バージョンチェック後に
ダイアログを呼び出すような内容になっています。

ダイアログは前回やったように
トップレベル（文書レベル）に記述していますので

後でも使えます

■レイヤ制御等

レイヤードPDFの
レイヤのON・OFFを使って

見た目を工夫する事が出来ます。

このような動作は
デザイナーさんと相談して決めて行けば良いですね
まぁ
簡単な物なら自分で書いても良いし
素材集とかでも良いですね。

後は
ShowHideを使って

添付パネルのOnOffなんかも良いかもしれません。

備考
ok　cancelの制御でもやりましたが

こんな風に流れますので

cancelなら『ドキュメントを閉じる』記述をすれば
キャンセルの後にも
アクションを実行させる事ができますね。

マルチライン【multiline: "true"】の
スタティックテキスト【type: "static_text"】は

テキストがコピー出来ますので

住所や電話番号とか.....
URLとか....
メールアドレスとか？
ユーザー名とパスワードとか？
なんだろ後......を表示させるのもアリかも

 
自分まとめ

必要に迫られてドキュメントを見ながら
自分が勉強した感じですが
AcrobatのJavascriptは作法に戸惑いを感じましたが
まぁ
工夫次第で『ある程度』は出来る事がわかりました。

注意点としては
文字コードと改行コードが
実行するマシンに依存するので
現時点では
MacintoshならMacSJISのMac改行
WindowsならWinSJISのWin改行
でないと日本語が通らないのが意外ですね。
まだ
AcrobatのJavaScriptエンジンがUTF8化されていないわけです。
次のバージョンあたりでは
さすがに変更されるかもしれませんが
その時は
フォルダレベルのスクリプトの文字コードを変更しなくてはなりませんね。
ドキュメントに記述されたJavaScriptもどうなるか？

その時が来たら慌てたいと......笑

[execDialog]ダイアログのmultilineオプション【その４】

AcrobatのJavaScriptsで
ダイアログについてです。

ダイアログの概要[LINK]と
【その１】[LINK]【その２】[LINK]【その３】[LINK]も参考にしてください
 

こんな感じのダイアログを出します。

■multiline　
multilineはスタティックテキストで

multiline: "true"を宣言するだけです。

■initialize　

multiline内に呼び出すテキストは
initializeセクションで

ロードする事で
反映されます。

改行やタブはおなじみの

\nや\tです。

■font
default　　　標準
dialog　　　　ダイアログ・ボックスフォント
palette　　　小文字
となっています。
ここでは
paletteを指定しています。

「A9R21232.x.pdf」をダウンロード[PDF]

[execDialog]Acrobatのダイアログ(キャンセル制御)【その２】

AcrobatのJvascripts
execDialog
についての【その２】

データの取得とキャンセル制御

execDialogで実行したダイアログへの入力を
取得してフォームへ反映させるわけですが

■デフォルトの文言を指定する
■キャンセルに対しての制御
■その他について
の３つを書きます。

■デフォルトの文言を指定する

流れはこんな感じ

initializeで文言を指定して
↓
dialog.loadでダイアログに反映させます

「A9R182513.01e.pdf」をダウンロード[PDF]

■キャンセルに対しての制御

キャンセル対策って事ではないけれども
一般的には
ダイアログの呼び出し前に

値を初期化しておくとことで
ユーザーのキャンセル等対応するわけですが
初期化をしないと
上記のPDFでダイアログに対してキャンセルを選ぶと
戻り値が空になりますので『undefined』になるか
初期化されていない格納されている値が呼び出されます。

Acrobatには
そこを制御するためにok_cancelが用意されています。

ダイアログの結果自体は
commitへ処理されますが
ダイアログの対話処理の結果である
OKやCancelについての処理の分岐を作れるわけですね。

「A9R182513.02e.pdf」をダウンロード[PDF]

■その他について
execDialogにはOKとCancel以外の処理も用意されています。

otherです。

typeで
type: "ok_cancel_other"を選択して

otherを設定します。

※otherはOKでもCancelでもないので単体ではダイアログを閉じません。
閉じる場合にはダイアログを閉じる事を記述します。
逆に
ダイアログを閉じないので
『数値チェック』や『ダイアログ内での計算』等で使えます。

otherで閉じる場合は

と
こんな感じの記述で良いんじゃないでしょうか

「A9R182513.03e.pdf」をダウンロード[PDF]

続く

[Dialog]Acrobatのダイアログ３種類の簡単な説明

AcrobatのJavaScriptエンジンには
３種類のダイアログボックスが用意されています。

App.alert
アラート[LINK]

App.response
レスポンス[LINK]

App.execDialog
実行形式ダイアログ[LINK]

の３種類です。それぞれ特徴があります。
私の理解している範囲ですが
説明してみたいと思います。

 
App.alert
アラートですね
一番わかりやすい文法ですし使い易い

■4種類の形式が用意されています。
■クリックしたボタンで戻り値が違います。

 
App.response
入力を求める対話式のダイアログ

■ユーザーに入力を求めます。
■入力ボックスは１つだけ
■伏せ字（パスワード等）も使えます。
■戻り値を使えます。

App.execDialog
自由度が高いけど文法作法が複雑なダイアログ

■チェックボックス　ラジオボックスが使えます。
■項目の数や構成は自由に設定できます。
■文法作法が複雑
■戻り値はそれぞれ自由に使えます。
■戻り値の分岐も出来ます。

AcrobatのJavaScriptsは
主にフォームの中で使われる事が多いですから
ダイアログで入力を求める事自体が
ちょっとナンセンス？な感じですが
入力補助として、使う事があるかもしれませんね

alertの記事で書きましたが
alertの戻り値はダイアログの種類で違いますし
キャンセルに対してnullではなくて
戻り値が返ります。

処理の分岐等使える事があるかもしれません

PDFフォームを作る人は覚えておくと良いかもしれませんね

[execDialog]Acrobatのダイアログ【その１】

AcrobatのJacascriptsダイアログ
execDialogについて

App.alertについてはこちら[LINK]
App.responseについてはこちら[LINK]を見てください

execDialogは他のアラートやレスポンスに比べると
■自由度が高い
かわりに
■文法作法がちょい複雑
に
なっています。

概要はこんな感じ

ダイアログの構造にもよりますが
シンプルな物だと

initialize　
dialog.load　初期化して　ダイアログを呼び出し

commit　
dialog.store　ダイアログの実行結果

description　
elements　ダイアログの本体

の３つの構造から出来ています。

description部が
ダイアログの本体を構成していて
オプション等色々用意されています。
本当に自由度は高いです。
descriptionの簡単な構造は

descriptionでサイズ等が宣言されて
後から来る
viewで構成要素を作ってく感じ？です。

view以下の構造で表示が決まりますので
同じような内容でもviewの作りが変われば

↑の図のように
色々な作りのダイアログが可能です。

「A9R182512.01e.pdf」をダウンロード[PDF]

チェックボックス　や　ラジオボタン
も選べますので
工夫次第だと思います。

続く

[alert]アラート Acrobat JavaScript

アイコンの種類の
nIcon

アラートの種類の
nType
はこちら[LINK]

サンプルのPDF
「A9R5344648.tmp.pdf」をダウンロード[PDF]

ここで注意したいのが
戻り値で処理を分岐するばあい
nTypeによって戻り値が違う点です。
注意しましょう

Google ChromeのPDFビューアも
今回のアップデート8.0.5から
フォームアクセスが出来るようになっています。
が
Acrobatとは互換がありません。
nTypeはどれを選んでも
ダイアログは

この形
戻り値は大丈夫ですが
ちゃんとした
互換が欲しいなぁ

[alert]アイコンnIcon と タイプnType

nIcon

0	Error (default)
1	Warning
2	Question
3	Status

nType

0	OK (default)
1	OK, Cancel
2	Yes, No
3	Yes, No, Cancel

「A9R432429.tmp.pdf」をダウンロード[PDF]

[JavaScript]AcrobatJavaScript入力ダイアログ

PDFフォームでダイアログを出して
入力し
入力結果をテキストフィールドに反映させます。

ボタンクリックで

ダイアログを出して

戻り値をテキストフイールドに
getField
します

スクリプト的には

こんな感じ
見た通りですが
ダイアログの

ここに対応しています

サンプルファイル
「A9R106329a.pdf」をダウンロード

[JavaScript]AcrobatJavaScriptアラートの記述『改行』

一般的な正規表現と同じです。

改行は『\n』
復帰は『\r』
タブは『\t』

他
\v 垂直タブ
\a ベル
\f 改頁
\e 退避修飾
等が一般的です

「A9R106329.pdf」をダウンロード

[JavaScript]AcrobatJavaScriptのコメント行

AcrobatのJavaScript記述中のコメント行は
//ではじめて；で閉じます
が
一般的な構文同様
はじめの//だけで大丈夫です。

サンプルファイル

「A9R106329.pdf」をダウンロード