整形ユーティリティ教書　基本編

鋭意校正中です。
念のためにブラウザでＦ５キーを押してリロードしてからお読みください。

　
fig.0　パレット型ランチャー：utx_list3_launcher.wfm/wfx

　【整形ユーティリティ　ダイアグラム】

　┌───────────────┐
　│整形ユーティリティのランチャー│
　│　　　　　　　　　　　　　　　│
　└──┬────────────┘
　　　　↓
　　　　├───────┬────────┬────────┬────────┐
　　　　↓　　　　　　　↓　　　　　　　　↓　　　　　　　　↓　　　　　　　　↓
　┌──┴───┐┌──┴───┐┌───┴────┐┌──┴────┐┌──┴───────┐
　│整形を開く　││クイック検索││dirでゲットだぜ ││表の定義リスト││フォームの定義リスト│
　│　　　　　　││　　　　　　││　　　　　　　　││　　　　　　　││　　　　　　　　　　│
　└──┬───┘└──┬───┘└───┬────┘└───────┘└──────────┘
　　　　↓　　　　　　　↓　　　　　　　　↓
　（１）～（４）　　［処理］でリンク　［ファイル名］でリンク
　diff（１）～（２）　　↓　　　　　　　　↓
　　　　↓　　　　　　　↓　　　　　　　　↓
┌───┴───────┴────────┘
│　　　　　　　┌────┐
│　　　　　　　│プリント│
│┌────┐┌────┐│┌────┐┌────┐
││テキスト││テキスト│┘│テキスト││クリップ│
││(ＷＢＳ)││(手続き)│　│(結果)　││ボード　│
│└────┘└────┘　└────┘└────┘
│　　↑　　　　　↑　　　　　　↑　　　　　↑　
│　出力　　　　出力　　　　　出力　　　　出力
│　　↑　　　　　↑　　　　　　↑　　　　　↑　
│┌────┐┌────┐　┌────┐　　↑┌────┐
││手続き　││ﾃｷｽﾄ印刷│　│変数ﾁｪｯｸ│　　↑│字下げ　│
││一覧　　││　　　　│　│　　　　│　　↑│設定　　│
│└─┬┬─┘└─┬┬─┘　└─┬┬─┘　　↑└┬───┘
│　　↑↓　　　　↑↓　　　　　↑↓ 　　　 ↑　│
│　リンク※　　リンク※　　　リンク※　　 ↑　│　　※［手続き名］でリンク
│　　↑↓　　　　↑↓　　　　　↑↓ 　　　 ↑　│
│　┌┴┴────┴┴─────┴┴──────┴┐
└→┤　　　　整形ユーティリティ　　　　　　（１）│───┐
　　│　　　　　　　　　　　　　　　　　　　　　　│（２）│───┐
　　└─┬────────────────────┘　　　│（３）│───┐
　　　　│　└──────────────────────┘　　　│（４）│──────┐
　　　　│　　　　　└──────────────────────┘　　　│　diff（１）│──────┐
　　　　│　　　　　　　　　└──────────────────────┘　　　　　　│　diff（２）│
　　┌─┴────┐　　　　　　　　　　　└──────────────────────┘　　　　　　│
　　│整形エンジン│　　　　　　　　　　　　　　　　　　└──────────────────────┘
　　│　　　　　　│
　　└──────┘
　　　　↑
　　　入力
　　　　↑
　　　　├─────────┬─────────┬─────────┐
　　　　↑　　　　　　　　　↑　　　　　　　　　↑　　　　　　　　　↑
　┌──┴───┐　　┌──┴───┐　　┌──┴───┐　　┌──┴───┐
　│イベント処理│┐　│一括処理　　│┐　│テキスト　　│┐　│K3ファイル　│┐
　│　　　　　　││┐│　　　　　　││┐│　　　　　　││┐│　　　　　　││┐
　└──────┘││└──────┘││└──────┘││└──────┘││
　　└──────┘│　└──────┘│　└──────┘│　└──────┘│
　　　└──────┘　　└──────┘　　└──────┘　　└──────┘

　┌───────────────┐
　│整形ユーティリティのランチャー│
　│　　　　　　　　　　　　　　　│
　└───┬───────────┘
　　　　　↓
　　┌──┴─────┐
　　│トレース出力整形│
　　│を開く　　　　　│
　　└──┬─────┘
　　　　　↓
　　┌──┴───────────────────┐
　　│トレース出力整形　　　　　　　　　　　　　　│
　　│　　　　　　　　　　　　　　　　　　　　　　│
　　└──┬────────────┬──────┘
　　　　　│　　　　　　　　　　　　│
　　┌──┴───┐　　　　　　┌─┴──┐
　　│整形エンジン│　　　　　　│ﾃｷｽﾄ印刷│
　　│　　　　　　│　　　　　　│　　　　│
　　└──────┘　　　　　　└────┘
　　　　　↑　　　　　　　　　　　　↓
　　　　入力　　　　　　　　　　　出力
　　　　　↑　　　　　　　　　　　　↓
　　┌──┴─────────┐┌────┐
　　│メモ帳にペーストして　　││テキスト│
　　│メモ帳を閉じます　　　　│└────┘┐
　　│　　　　　　　　　　　　│　│プリント│
　　└────────────┘　└────┘
　　　　　↑
　　┌──┴─────────┐
　　│トレース出力ウィンドウの│
　　│内容を右クリックして　　│
　　│コピーします　　　　　　│
　　└────────────┘

１　整形ユーティリティの概要

１．１　［字下げ］をするためのアプリケーション
　［ if ... else ... end］等の制御構造を［字下げ］して、読み易く書かれたプログラムは判り易い。
しかし、Ｗｉｎ桐のイベント定義画面には制御構造を［字下げ］する機能がありません。
そこで、イベント処理( kev/kex ) を読み込んで自動的に整形して［字下げ］するのが［整形ユーティリティ］なのです。

　ただし、直接的にイベント処理( kev/kex ) を書き換えることはできませんので、
　　・クリップボードにコピー　　 … 行単位
　　・テキストファイルに書き出し … 手続き単位
　のどちらかの方法で、整形結果をイベント処理( kev/kex ) に反映することになります。

　すなわち、
行単位でクリップボードにコピーした場合には、イベント定義画面で［編集］→［貼り付け］で貼り付けます。
手続き単位でテキストファイルに書き出した場合には、イベント定義画面で［読み込み］→［テキスト］でテキストファイルを読み込みます。

　このように間接的な方法でしか整形結果をイベント処理( kev/kex ) に反映出来ないのが欠点ですが、
それでも［整形ユーティリティ］にはそのような欠点を補って余りある効果があります。

　■字下げの設定

　［字下げのパラメータ］は４つあります。

　□ … 左インデント　　　　　　　※１以上　デフォルト値は１
　△ … ネスト（入れ子）の字下げ　※１以上　デフォルト値は１
　× … ケース（条件）の字下げ　　※０以上　デフォルト値は１
　○ … \ で継続する２行め以降　　※０以上　デフォルト値は１

　以下の例は、字下げを（目だ立たせて）判り易くするためにすべてのパラメータの値を２に設定しています。

　【表示】

　ダイアグラム（罫線）が表示されます。

　手続き定義開始　procedure( )

　□┌if　( 条件 )
　□│△△・・・・・・・・・・・￥
　□│△△○○・・・・・・・・・・
　□│△┌ケース開始
　□│△├──ケース　( 条件 )
　□│△│××□□・・・・・・・・・
　□│△└ケース終了
　□└end

　手続き定義終了

　※□△×○は、すべて全角空白文字です。

　【出力】
　・クリップボードにコピー　　 … 行単位
　・テキストファイルに書き出し … 手続き単位

　ダイアグラム（罫線）は出力しません。※テキストファイルに書き出す場合に限り、ダイアグラム（罫線）も出力できます。

　手続き定義開始　procedure( )

　□□if　( 条件 )
　□□△△・・・・・・・・・・・￥
　□□△△○○・・・・・・・・・・
　□□△△ケース開始
　□□△△××ケース　( 条件 )
　□□△△××□□・・・・・・・・・
　□□△△ケース終了
　□□end

　手続き定義終了

　※□△×○は、すべて全角空白文字で出力されます。

　■行動ダイアグラムの対象になる［実行制御］文

　―if ... else ... end

　┌if
　│
　│
　├else
　│
　│
　└end

　―繰り返し (条件) ... 繰り返し終了

　┌繰り返し　(条件)
　│
　│
　│
　└繰り返し終了

　―ケース開始 ... ケース　(条件) ... ケース終了

　┌ケース開始
　├─ケース　(条件)
　│
　│
　├─ケース　その他
　│
　│
　└ケース終了

　■行動ダイアグラムの対象になる［脱出命令］

　―繰り返し中止( break )

　┌繰り返し　(条件)
　│
　│
　←─繰り返し中止
　└繰り返し終了

　―ケース中止( break )

　┌ケース開始
　├─ケース　(条件)
　│
　←──ケース中止
　│
　├─ケース　その他
　│
　│
　└ケース終了

　―手続き終了( return )

　手続き定義開始　procedure( )

　←手続き終了
　手続き定義終了

１．３　整形ユーティリティは印刷専用アプリケーションではない
　整形ユーティリティは印刷専用アプリケーションではありません。
もちろん、印刷機能は用意されていますが、それはメインの機能ではありません。
確かに、行数が多い手続きの場合などでは、印刷して机上で検討することが有効な場合がありますが、それは例外です。
紙を浪費する印刷は避けることをお勧めします。

　【引用】木を守る ― UNIXという考え方 ISBN4-274-06406-9 より
　　「データを紙に印刷してしまったら、もうそれ以上操作できないんだぞ」と、上司は言った。
　　紙に印刷されたデータは、並べ替えも、移動も、フィルタ処理も、変形も、修正もできない。
　　少なくともコンピュータ上でやるように簡単にはできない。
　　　：
　　動かせないデータは死んだも同然だと前にいったことを覚えているだろうか？
　　紙に印刷されたデータも同じだ。
　　　：
　　紙には気を付けることだ。それはデータの死亡証明書といっていい。

１．４　整形ユーティリティはテキストデータを出力するアプリケーションである
　整形ユーティリティはテキストデータを出力するアプリケーションです。

　―行単位でクリップボードにコピーした場合には、
　・イベント定義画面で［編集］→［貼り付け］で貼り付けます。

　―手続き単位でテキストファイルに書き出した場合、
　・イベント定義画面で［読み込み］→［テキスト］でテキストファイルを読み込みます。

２　整形ユーティリティはコンバータ
　整形ユーティリティはデータを変換するコンバータとして利用できます。
［入力→変換→出力］の流れを以下に示します。

　　　　　　　　　　　　　　　　　　　　　　┌───┐
　【入力】　　　　　　　　　　【変換】　　　│字下げ│　　　　　　　　　　　　【出力】
　　　　　　　　　　　　　　　　　　　　　　│設定　│
　イベント処理( kev/kex ) ┐　　　　　　　　└─┬─┘
　　　　　　　　　　　　　│　┌────────┴────────────┐
　ライブラリ( cmd/cmx )　 ┤　│　　　　　　　　　　　　　　　　　　　　　│　┌ クリッップボード
　　　　　　　　　　　　 ├→┤整形ユーティリティ（１）（２）（３）（４）├→┤
　テキスト　( txt )　　　 ┤　│　　　　　　　　　　　　　　　　　　　　　│　└ テキスト( txt )
　　　　　　　　　　　　 │　└─────────────────────┘　
　Ｋ３　　　( K3　)　　　 ┘

　―複数行のデータをクリップボードへコピーする
　整形ユーティリティの行を［Ctrl + クリック］または［Shift + クリック］すると行の色が紺色に変わります。
この状態で整形ユーティリティ本体の［クリップボードへコピー］ボタンを実行すると紺色の行のデータがクリップボードへコピーされます。
コピーが終了すると紺色のデータ行の色は元に戻ります。
クリップボードへコピーしたデータは桐のイベント編集画面・一括編集画面で貼りつけることができます。
一度にクリップボードへコピーできる文字数は、桐9-2012/桐9sでは最大４０００文字まで、桐10/桐10sでは最大８０００文字です。
一度に全部の行をコピーできない場合は、コピー終了後に残りの紺色の行の先頭へ自動的にジャンプします。
紺色になった行を解除するには［Ctrl + クリック］または［Ctrl + Shift + クリック］します。
※［Shift + クリック］／［Ctrl + Shift + クリック］は通常のWindowsの操作と異なる動作をします。ご了承下さい。

　―テキストファイルを出力する
　［テキスト/印刷］ダイアログを開いて［テキスト］ボタンを実行すると［テキストの保存］ダイアログが開きます。
任意のテキストファイル名を指定して［保存］ボタンを実行してください。

　【優先順位１位】
　［名札メインとイベントハンドラと一般手続き］で、名札メインが最優先で、次がイベントハンドラで最後が一般手続きの順番になります。

　　┌イベントハンドラ
　　│　├ 1　名札　メイン
　　│　├ 2　フォーム
　　│　├ 3　フォームヘッダ部
　　│　├ 4　フォーム明細部
　　│　├ 5　フォームフッタ部
　　│　└ 6　その他のオブジェクト　※その他のオブジェクトは、辞書順でソート
　　│
　　└── 7　一般手続き　※辞書順でソート

　　※数字 1 から 7 は優先順

　【優先順位２位】
　　イベントの種類です。※順番はイベントの発生順ではありません。

　　フォーム開始，フォーム終了，レコード移動，グループ移動，行削除開始，行削除終了
　　行訂正開始，行訂正終了前，行訂正エラー，行訂正終了
　　行挿入開始，行挿入終了前，行挿入エラー，行挿入終了
　　グループ検索開始，グループ検索終了，グループ追加開始，グループ追加終了，グループ値訂正開始，グループ値訂正終了
　　マウス左ダウン，マウス左アップ，マウス右ダウン，マウス右アップ，マウス移動
　　キーダウン，キーアップ，キー入力，システムキーダウン，システムキーアップ，タイマー１，タイマー２

　　フォーカス取得，フォーカス喪失，入力前，編集開始，入力後，ソース値更新，編集文字列変更，選択値変更
　　マウスインアウト，マウス左ダウン，マウス左アップ，マウス左クリック，マウス右ダウン，マウス右アップ
　　マウス移動，入力支援オープン，入力支援クローズ