編集の要約なし |
編集の要約なし |
||
| 1行目: | 1行目: | ||
= | = [[マクロライブラリ]]に投稿したマクロ = | ||
== 「テキスト操作補助」 カテゴリ == | == 「テキスト操作補助」 カテゴリ == | ||
| 105行目: | 105行目: | ||
ファイル:Mery_小マクロ集_アウトライン.png|heights=320px|小マクロ集 アウトラインイメージ | ファイル:Mery_小マクロ集_アウトライン.png|heights=320px|小マクロ集 アウトラインイメージ | ||
</gallery><br clear=all> | </gallery><br clear=all> | ||
= 外部サイトに投稿したマクロ = | |||
* [https://pastebin.com/5rUw36qM StrConvテキスト変換メニュー] (uploaded: 2018/08/25) <br> 山本隆 氏作成の [http://gesource.jp/soft/strconv/strconvdll.html 文字変換ライブラリ StrConvDLL] の機能をポップアップメニューにまとめたマクロ | |||
* [https://pastebin.com/Bci0eEx2 gPad用 文字数・行数・ヒット数] (uploaded: 2019/08/26) <br> Mery 用マクロ「[[検索ヒット数表示(選択文字列)#機能強化バージョン|文字数・行数・ヒット件数(選択文字列)]]」を gPad 用に改編したもの | |||
| 375行目: | 379行目: | ||
現在の表示状態を取得してから ON/OFF を指定しての切り替えを行なうためには、include ライブラリの IO クラスを利用するなどして外部に Mery.ini とは別の設定ファイル (e.g. JSON ファイル) を利用して、切り替え実行のたびに設定ファイルを読み書きする必要がある。<br> | 現在の表示状態を取得してから ON/OFF を指定しての切り替えを行なうためには、include ライブラリの IO クラスを利用するなどして外部に Mery.ini とは別の設定ファイル (e.g. JSON ファイル) を利用して、切り替え実行のたびに設定ファイルを読み書きする必要がある。<br> | ||
この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー などから切り替えをすると最新の設定状態とマクロの設定ファイルとのあいだに齟齬が生じてしまう。 | この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー などから切り替えをすると最新の設定状態とマクロの設定ファイルとのあいだに齟齬が生じてしまう。 | ||
== 警告・確認ダイアログとステータスバーの使い分け == | |||
マクロからユーザーにメッセージを与える手段として [[マクロリファレンス:Window インターフェイス#Alert メソッド|警告(Window.Alert)]]・[[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認(Window.Confirm)]]ダイアログと [[マクロリファレンス:Window インターフェイス#Status プロパティ|ステータスバー(Window.Status)]]での表示などがある(ほかに [[マクロリファレンス:OutputBar インターフェイス#Write メソッド|アウトプットバー(OutputBar.Write)]]やポップアップメニューを使う方法もある)。<br> | |||
Mery のマクロで利用できるダイアログは、両方ともサウンドが発生し、ボタン操作で閉じるまで作業を中断させてしまうものなので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | |||
<br> | |||
※ ユーザー側がステータス表示を使用するイベントマクロなどを別途で導入していることを考慮すると、マクロの終了時になんらかのイベントが発生するマクロの場合、重要なメッセージはダイアログで出力させるか、マクロ内の動作設定用の変数で出力方法を選択できるようにしておくとなお良い。 | |||
<br><br> | |||
Mery の Window クラスのメソッド・プロパティを使うほかにも、WSH の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364428(v=msdn.10) WshShell.Popup メソッド] によるメッセージボックス利用することもできる。<br> | |||
ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、あまりお勧めはできない…。 | |||
== エラー処理 == | |||
Mery のマクロでエラーが発生した場合、ダイアログのポップアップにより中断される。<br> | |||
マクロの開発者側にとってはソースファイル内の例外が発生した行に速やかにアクセスできるので便利ではあるが、コードを読むのに不慣れなユーザーにおいてはソースコードを開いたところで何が解決するわけでもない。<br> | |||
エラーダイアログは自家用マクロのメンテナンスには有用であるが、公開用のマクロの場合はユーザーがソースコードに誤った改変を加えてしまうおそれもあり、基本的に必要性がない。 | |||
<br><br> | |||
例外が発生することが予期できたり、例外が発生してもそれを無視してマクロの実行を継続したり回避用の処理に移行させられる場合は、JavaScript の [[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Exception_Handling_Statements/try...catch_Statement try...catch 文] を組み込むとよい。 | |||
<source lang="javascript"> | |||
// e.g. コピーや上書き保存のようなファイルシステムを操作するマクロは | |||
// アクセス権限不足や読取専用ファイルへの書き込みなど | |||
// ユーザーの実行環境により例外が発生する可能性がある | |||
try { | |||
/* | |||
* 例外が発生する可能性のあるコード | |||
* (例外が発生しなかったときはそのまま処理される) | |||
* | |||
* ※ このブロック内で例外が発生したとき | |||
* 原因箇所より後ろのコードは処理されず | |||
* catch や finally ブロックにジャンプする | |||
*/ ; | |||
} | |||
catch( e ) { | |||
/* | |||
* 例外が発生したときにだけ実行されるコードブロック | |||
* (例外が発生しなかったときは処理されない) | |||
* | |||
* エラーの内容を特定して予期できるなら | |||
* catch( e if e == hoge ) { ... ; } | |||
* catch( e if e == fuga ) { ... ; } | |||
* catch( e.number == -xxxxxxxxxx ) { ... ; } | |||
* のように列記して処理を分岐させてもよい。 | |||
* ※ if を使う場合、カッコ () や else は記述不要 | |||
* | |||
* ・Alert(), Confirm() や Status= でメッセージを表示させたり | |||
* 回避処理用のコードを記述したりしてもよい。 | |||
* ・Quit() だけ記述しておいて、エラーダイアログなしで | |||
* マクロを終了させてもよい。 | |||
* ・セミコロンだけおいて {;} とすれば、エラーを無視して | |||
* catch(e) {;} よりうしろのコードを処理させることもできる。 | |||
*/ ; | |||
} | |||
finally { | |||
/* | |||
* 例外が発生してもしなくても処理されるコード | |||
* (例外が発生したときは catch ブロックの後に実行される) | |||
* ※ finally{} ブロックはまるごと省略可 | |||
* | |||
* Scripting.FileSystemObject や ADODB.Stream でファイルを開いている場合は | |||
* ここでリソースを解放してやるとよい。 | |||
* | |||
* try ... catch 文を関数コード function(){ ... } 内においている場合は | |||
* return piyo; | |||
* などで戻り値を返してやってもよい。 | |||
* | |||
* ※ catch ブロックで Quit(); や return ***; を記述している場合は | |||
* エラーが発生したときに finally ブロックは処理されない | |||
* | |||
*/ ; | |||
} | |||
/* | |||
* 上で Quit(); や return ***; を記述していない場合は | |||
* try ... catch 文のあとのコードも処理される | |||
*/ ; | |||
</source> | |||
== その他、拙作マクロについて == | == その他、拙作マクロについて == | ||
| 385行目: | 464行目: | ||
: ※「表示座標(表示行)」ベースでの動作テストはほとんどしていません。 | : ※「表示座標(表示行)」ベースでの動作テストはほとんどしていません。 | ||
* ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。 | * ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。 | ||
* ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ]] | * ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ]]」マクロを利用しやすいように(個人的にタグジャンプ系のマクロに馴染めないので)、マクロのコードには半角空白を多用しています。 | ||
* | * 基本的に、変数名は頭文字が小文字の camelCase に、関数名は頭文字が大文字の TitleCase にしてあります。 | ||
<br> | <br> | ||
* 「[[includeライブラリ|include ライブラリ]] (作成: ks 氏)」を利用する【'''include 版'''】と利用しない【'''通常版'''】とがあるマクロでは、include | * 「[[includeライブラリ|include ライブラリ]] (作成: ks 氏)」を利用する【'''include 版'''】と利用しない【'''通常版'''】とがあるマクロでは、include 版(←自家用)を優先的にメンテ・更新しています。 | ||
* 外部実行ファイル「[[GetKeyState.exe(キー状態取得実行ファイル)|GetKeyState.exe]] (作成: pizz 氏)」の導入が必要なものもあります。[https://www.haijin-boys.com/wiki/GetKeyState.exe(%E3%82%AD%E3%83%BC%E7%8A%B6%E6%85%8B%E5%8F%96%E5%BE%97%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB)#.E3.81.9D.E3.81.AE.E4.BB.96] | * 外部実行ファイル「[[GetKeyState.exe(キー状態取得実行ファイル)|GetKeyState.exe]] (作成: pizz 氏)」の導入が必要なものもあります。[https://www.haijin-boys.com/wiki/GetKeyState.exe(%E3%82%AD%E3%83%BC%E7%8A%B6%E6%85%8B%E5%8F%96%E5%BE%97%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB)#.E3.81.9D.E3.81.AE.E4.BB.96] | ||
* ポップアップメニューマクロの「設定変更サブメニュー」など、複数のマクロで共通の自作関数を使用しているものがありますが、当面は「include ライブラリ」のような外部ファイルにまとめる予定なしです。 | * ポップアップメニューマクロの「設定変更サブメニュー」など、複数のマクロで共通の自作関数を使用しているものがありますが、当面は「include ライブラリ」のような外部ファイルにまとめる予定なしです。 | ||
: ※ すでに公開しているマクロが多いこと、公開用と自家用とでコードの内容がちがうマクロが複数あること、それぞれのマクロごとに関数のコードに改変をくわえていることなどの理由で、関数・クラスを統一しなおして更新メンテするのが困難。 | : ※ すでに公開しているマクロが多いこと、公開用と自家用とでコードの内容がちがうマクロが複数あること、それぞれのマクロごとに関数のコードに改変をくわえていることなどの理由で、関数・クラスを統一しなおして更新メンテするのが困難。 | ||
<br> | <br> | ||
* 「[[マテリアルデザインっぽいアイコンと『小マクロ集』|マテリアルデザインっぽいアイコン]]」は、sukemaru の自作マクロと、sukemaru | * 「[[マテリアルデザインっぽいアイコンと『小マクロ集』|マテリアルデザインっぽいアイコン]]」は、sukemaru の自作マクロと、sukemaru がマクロライブラリからダウンロードして利用しているマクロを対象として制作しています。 | ||
= | = 投稿した[[構文ファイル]] = | ||
* [[Mery MSY]] (uploaded: 2018/09/05) | * [[Mery MSY]] (uploaded: 2018/09/05) | ||
| 431行目: | 510行目: | ||
: マクロバーのアイテム数 16 件、ラベルあり(#title="hoge" の文字数を切りつめてやり繰り) | : マクロバーのアイテム数 16 件、ラベルあり(#title="hoge" の文字数を切りつめてやり繰り) | ||
: [[ファイル:Mery_2.7.4_SS.png|link=https://www.haijin-boys.com/wiki/images/3/3f/Mery_2.7.4_SS.png|480px|thumb|left|Ver. 2.7.4]]<br clear=all> | : [[ファイル:Mery_2.7.4_SS.png|link=https://www.haijin-boys.com/wiki/images/3/3f/Mery_2.7.4_SS.png|480px|thumb|left|Ver. 2.7.4]]<br clear=all> | ||
スポンサーリンク