編集の要約なし |
編集の要約なし |
||
| 134行目: | 134行目: | ||
meMenuSeparator = 4 | meMenuSeparator = 4 | ||
</source> | </source> | ||
となるので、真偽値が true=1 / false=0 で評価されることを利用して、真偽値を返す変数や条件式を代入することができる(ただし Number | となるので、真偽値が true=1 / false=0 で評価されることを利用して、真偽値を返す変数や条件式を代入することができる(ただし Number 型に変換する必要がある → 算術演算子「+」をつけるなど)。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
var menu = CreatePopupMenu(); | var menu = CreatePopupMenu(); | ||
| 181行目: | 181行目: | ||
/** | /** | ||
* ポップアップメニューに表示するラベルを整形する | * ポップアップメニューに表示するラベルを整形する | ||
* | |||
* ※ 不要な置換については .replace( ... ) の行を 削除/コメントアウト してよい | |||
* | * | ||
* ・行頭空白を除去 | * ・行頭空白を除去 | ||
| 191行目: | 193行目: | ||
* ・判別しづらい ascii 記号 !"%'(),.:;@[]`{|} を全角に置換 | * ・判別しづらい ascii 記号 !"%'(),.:;@[]`{|} を全角に置換 | ||
* ・「a-z」を全角に置換 | * ・「a-z」を全角に置換 | ||
*/ | */ | ||
| 199行目: | 199行目: | ||
var menuWidth = 55; // 切り捨ての閾値 | var menuWidth = 55; // 切り捨ての閾値 | ||
menuKey = str.replace( /^[\t ]+/, "" ) | var menuKey = str.replace( /^[\t ]+/, "" ) | ||
.replace( /(?:\t|[ ]{3,}|[ ]{2,})+/g, " › " ) | |||
.slice( 0, menuWidth ) | |||
.replace( /\r?\n/g, "⏎ " ) | |||
.replace( /[&]/g, "&&" ) | |||
.replace( /[\\]/g, "∖" ) | |||
.replace( /[\u00A0\u1680\u180e\u2000-\u200A\u2028\u2029\u202F\u205F\uFEFF]/g, "▯" ) | |||
.replace( /[!"%'(),.:;@\[\]`a-z{|}]/g, | |||
function( tmp ) { | |||
return String.fromCharCode( tmp.charCodeAt( 0 ) + 0xFEE0 ) | |||
} ); | |||
// 文字数を切り詰めた場合は「 ...」を付加 | // 文字数を切り詰めた場合は「 ...」を付加 | ||
menuKey += ( str > menuWidth ) ? " ..." : ""; | menuKey += ( str > menuWidth ) ? " ..." : ""; | ||
// アクセラレータつきの番号を付加 | // ※ アクセラレータつきの番号を付加 | ||
menuKey = "&" + y + ": " + menuKey; | menuKey = "&" + y + ": " + menuKey; | ||
| 224行目: | 224行目: | ||
=== 配列からポップアップメニューを生成 === | === 配列からポップアップメニューを生成 === | ||
for | [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Loop_Statements/for_Statement for 文] などの[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Loop_Statements/for_Statement ループ処理] によって配列からポップアップメニューのアイテムを生成する場合に、[[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] の第二引数 '''Id''' (※通常は 1 ~ )と配列のアイテムのインデックス '''[ i ]''' の値(※通常は 0 ~ )を一致させたいときは、配列の先頭にダミーまたは空の要素を置いておき、ループ処理の開始インデックスを 1 にする。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
var a = new Array( "" ); | var a = new Array( "" ); // 先頭に空のダミー要素を入れておく | ||
a.push( "あああ" ); | a.push( "あああ" ); | ||
a.push( "いいい" ); | a.push( "いいい" ); | ||
| 251行目: | 251行目: | ||
<br> | <br> | ||
* [[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] では [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|Add() メソッド]] の第三引数(meMenuChecked, meMenuGrayed, meMenuSeparator)は使用できない。 | * [[マクロリファレンス:PopupMenu インターフェイス#AddPopup メソッド|PopupMenu.AddPopup() メソッド]] では [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|Add() メソッド]] の第三引数(meMenuChecked, meMenuGrayed, meMenuSeparator)は使用できない。 | ||
: サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように PopupMenu.AddPopup() 周りを if() | : サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように PopupMenu.AddPopup() 周りを if() 文で囲うしかない。 | ||
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。 | : 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。 | ||
| 260行目: | 260行目: | ||
ポップアップメニューマクロであれば、メニュー項目から動作設定をカスタマイズできるようにコーディングすることができる。 | ポップアップメニューマクロであれば、メニュー項目から動作設定をカスタマイズできるようにコーディングすることができる。 | ||
<br> | <br> | ||
* まず、[[利用者:Masme|masme]] 氏の「[[行並べ替え]]」や「[[連番を挿入]] | * まず、[[利用者:Masme|masme]] 氏の「[[行並べ替え]]」や「[[連番を挿入]]」マクロのように、[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/do...while do ... while() 文] によるループを利用して、動作設定の既定値を何度も書き換えながらポップアップメニューを再描画する方法がある。 | ||
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。 | : 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。 | ||
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読みなおす・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。 | |||
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]] | : これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serealize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。 | ||
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serealize / Deserialize | |||
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | : 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | ||
: ※ 非 include | : ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。 | ||
== 選択範囲の 先頭位置/末尾位置 == | == 選択範囲の 先頭位置/末尾位置 == | ||
| 308行目: | 307行目: | ||
== カレントディレクトリ == | == カレントディレクトリ == | ||
カレントディレクトリ(作業フォルダ)は、Mery を起動したときに決定され、一定ではない。<br> | |||
記述の都合上で相対パスを利用するために特定のカレントディレクトリを指定するマクロもあるが、「あえて流動的なカレントディレクトリを利用する」ようなコードが続く場合は、カレントディレクトリを書きもどす必要がある。 | |||
<source lang="javascript"> | <source lang="javascript"> | ||
var fso = new ActiveXObject( "Scripting.FileSystemObject" ); | var fso = new ActiveXObject( "Scripting.FileSystemObject" ); | ||
| 334行目: | 333行目: | ||
== 動作要件としてのバージョンチェック == | == 動作要件としてのバージョンチェック == | ||
Mery ベータ版で追加されたマクロ用プロパティを利用する場合は、マクロの動作要件として Mery 本体のバージョンチェックをするコードを入れておくのが無難である。<br> | 公開するマクロに Mery ベータ版で追加されたマクロ用プロパティを利用する場合は、マクロの動作要件として Mery 本体のバージョンチェックをするコードを入れておくのが無難である。<br> | ||
JavaScript | JavaScript には特定のプロパティがオブジェクト配下に定義されているかを調べる方法[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty]が色々とあるが、専用の組み込み関数 [[Mery本体のバージョンチェック|VersionCheck()]] を利用すれば Mery のバージョン番号を指定してのチェックができる。 | ||
<br> | <br> | ||
== 外部リソースのチェック == | == 外部リソースのチェック == | ||
[[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | * [[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | ||
ユーザー側で include ライブラリが導入されていて、マクロ側で | : ユーザー側で include ライブラリが導入されていて、マクロ側で | ||
#include "include/IO.js" | #include "include/IO.js" | ||
のようなプリフィクスがソースコードの先頭で宣言されていれば問題ないのだが、include ライブラリが導入されていなくても、プリフィクスを削除(コメントアウト)すればマクロがある程度動くようにコーディングすることもできる。 | : のようなプリフィクスがソースコードの先頭で宣言されていれば問題ないのだが、include ライブラリが導入されていなくても、プリフィクスを削除(コメントアウト)すればマクロがある程度動くようにコーディングすることもできる。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
// #include "include/IO.js" | // #include "include/IO.js" | ||
| 353行目: | 352行目: | ||
</source> | </source> | ||
<br> | <br> | ||
また、[[GetKeyState.exe(キー状態取得実行ファイル) | * また、[[GetKeyState.exe(キー状態取得実行ファイル)]] のあるなしで動作内容を分けるなら、以下のようにコードを記述すればよい。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
// あらかじめ変数 ctrl に 0 を代入しておく | // あらかじめ変数 ctrl に 0 を代入しておく | ||
| 361行目: | 360行目: | ||
var getKeyState = editor.FullName.replace( /mery\.exe$/i , "" ) | var getKeyState = editor.FullName.replace( /mery\.exe$/i , "" ) | ||
+ "Macros\\GetKeyState.exe"; | + "Macros\\GetKeyState.exe"; | ||
var fso = new ActiveXObject( "Scripting.FileSystemObject" ); | |||
if ( fso.FileExists( getKeyState ) ) { | |||
// GetKeyState.exe からの戻り値(Ctrl キーの押し下げ状態)を取得する | // GetKeyState.exe からの戻り値(Ctrl キーの押し下げ状態)を取得する | ||
var | var wshShell = new ActiveXObject( "WScript.Shell" ); | ||
ctrl = | ctrl = wshShell.Run( "\"" + getKeyState + "\" control", 0, true ); | ||
} | } | ||
| 379行目: | 379行目: | ||
* 取得できる項目がきわめて限定的である | * 取得できる項目がきわめて限定的である | ||
* 取得する項目が複数あると、その都度 Mery.ini 全体の読み込みが発生する(キャッシュ可) | * 取得する項目が複数あると、その都度 Mery.ini 全体の読み込みが発生する(キャッシュ可) | ||
* Mery.exe のファイル名を変更 (e.g. Mery_hoge.exe) している場合、MeryInfo.js のコードを改変しないと Mery.ini (Mery_hoge.ini) | * Mery.exe のファイル名を変更 (e.g. Mery_hoge.exe) している場合、MeryInfo.js のコードを改変しないと Mery.ini (Mery_hoge.ini) のパスを得られず、設定値を取得できない。 | ||
<br> | <br> | ||
拙作の組み込み関数 [[Mery.iniのオプション値を取得#GetIniOption() 関数|GetIniOption()]] と [[Mery.iniのオプション値を取得#GetIniOption2() 関数|GetIniOption2()]] はこれらの制約を受けず、とくに後者は Mery.ini のすべての項目にアクセスして値を取得することができる。<br> | 拙作の組み込み関数 [[Mery.iniのオプション値を取得#GetIniOption() 関数|GetIniOption()]] と [[Mery.iniのオプション値を取得#GetIniOption2() 関数|GetIniOption2()]] はこれらの制約を受けず、とくに後者は Mery.ini のすべての項目にアクセスして値を取得することができる。<br> | ||
ただし、制約がない代わりに組み込み関数自体のコードが長いことや、引数や戻り値が配列であることでコードが煩雑にならざるをえない( ⇔ 配列を使用することで、複数の項目を取得する場合でも Mery.ini ファイルの読み込みを1回におさえられる)。 | |||
<br><br> | <br><br> | ||
また、Mery.ini 側の仕様として、 | また、Mery.ini 側の仕様として、 | ||
「オプション」など各種の設定ダイアログを [OK] | 「オプション」など各種の設定ダイアログを [OK] ボタンで閉じたときか、 | ||
エディタウインドウを閉じたときにしか Mery.ini への書き込みがされないため、 | |||
メニュー項目/ツールバーアイコン/ショートカットキー で変更した設定内容は | |||
Mery.ini に直ちに反映されない | |||
という制約がある(Mery.ini の実体ファイルへの書き込み回数を減らすための仕様)。 | という制約がある(Mery.ini の実体ファイルへの書き込み回数を減らすための仕様)。 | ||
<br><br> | <br><br> | ||
エディタの表示状態をトグル切り替えするコマンド(縦書き、色の反転、全画面表示、etc. ...)については、マクロから「現在の表示状態」を取得する手段がなく、組み込み関数で Mery.ini から読み込んでも「最新の設定状態」を取得できるわけではない…。 | |||
<br><br> | <br><br> | ||
「現在の表示状態」を取得してから ON/OFF を指定しての切り替えを行なうためには、include ライブラリの IO クラスを利用するなどして外部に Mery.ini とは別の設定ファイル (e.g. JSON ファイル) を用意して、切り替え実行のたびに設定ファイルを読み書きする必要がある。<br> | |||
この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー | ※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。 | ||
== 警告・確認ダイアログとステータスバーの使い分け == | == 警告・確認ダイアログとステータスバーの使い分け == | ||
マクロからユーザーにメッセージを与える手段として [[マクロリファレンス:Window インターフェイス#Alert メソッド|警告(Window.Alert)]]・[[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認(Window.Confirm)]]ダイアログと [[マクロリファレンス:Window インターフェイス#Status プロパティ|ステータスバー(Window.Status)]] | マクロからユーザーにメッセージを与える手段として [[マクロリファレンス:Window インターフェイス#Alert メソッド|警告(Window.Alert)]]・[[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認(Window.Confirm)]]ダイアログと [[マクロリファレンス:Window インターフェイス#Status プロパティ|ステータスバー(Window.Status)]]への表示などがある(ほかに [[マクロリファレンス:OutputBar インターフェイス#Write メソッド|アウトプットバー(OutputBar.Write)]]やポップアップメニューを使う方法もある)。<br> | ||
Mery | Mery のマクロで利用できるポップアップダイアログは、両方ともサウンドをともない、ボタン操作で閉じるまで作業を中断させてしまうので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | ||
<br> | <br> | ||
※ ユーザー側がステータス表示を使用するイベントマクロなどを別途で導入していることを考慮すると、マクロの終了時になんらかのイベントが発生するマクロの場合、重要なメッセージはダイアログで出力させるか、マクロ内の動作設定用の変数で出力方法を選択できるようにしておくとなお良い。 | ※ ユーザー側がステータス表示を使用するイベントマクロなどを別途で導入していることを考慮すると、マクロの終了時になんらかのイベントが発生するマクロの場合、重要なメッセージはダイアログで出力させるか、マクロ内の動作設定用の変数で出力方法を選択できるようにしておくとなお良い。 | ||
<br><br> | <br><br> | ||
また、Mery の Window クラスのメソッド・プロパティを使うほかにも、WSH の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364428(v=msdn.10) WshShell.Popup メソッド] によるメッセージボックス利用することもできる。<br> | |||
ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] | ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、[はい], [いいえ], [キャンセル] の3ボタンが必要な場合でもなければお勧めはしない…。 | ||
== エラー処理 == | == エラー処理 == | ||
Mery のマクロでエラーが発生した場合、ダイアログのポップアップにより中断される。<br> | Mery のマクロでエラーが発生した場合、ダイアログのポップアップにより中断される。<br> | ||
マクロの開発者側にとってはソースファイル内の例外が発生した行に速やかにアクセスできるので便利ではあるが、コードを読むのに不慣れなユーザーにおいてはソースコードを開いたところで何が解決するわけでもない。<br> | マクロの開発者側にとってはソースファイル内の例外が発生した行に速やかにアクセスできるので便利ではあるが、コードを読むのに不慣れなユーザーにおいてはソースコードを開いたところで何が解決するわけでもない。<br> | ||
エラーダイアログは自家用マクロのメンテナンスには有用であるが、公開用のマクロの場合はユーザーがソースコードに誤った改変を加えてしまう惧れもあり、基本的に必要性がないといえる。 | |||
<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"> | <source lang="javascript"> | ||
// e.g. コピーや上書き保存のようなファイルシステムを操作するマクロは | // e.g. コピーや上書き保存のようなファイルシステムを操作するマクロは | ||
// | // アクセス権限や読取専用ファイルへの書き込み、パスの指定ミスなど | ||
// ユーザーの実行環境により例外が発生する可能性がある | // ユーザーの実行環境により例外が発生する可能性がある | ||
| 428行目: | 431行目: | ||
* (例外が発生しなかったときは処理されない) | * (例外が発生しなかったときは処理されない) | ||
* | * | ||
* エラーの内容を特定して予期できるなら | * ・Alert(), Confirm() や Status= でメッセージを表示させたり | ||
* 回避処理用のコードを記述したりしてもよい。 | |||
* | |||
* ※ エラーの内容を特定して予期できるなら | |||
* catch( e if e == hoge ) { ... ; } | * catch( e if e == hoge ) { ... ; } | ||
* catch( e if e == fuga ) { ... ; } | * catch( e if e == fuga ) { ... ; } | ||
* catch( e.number == -xxxxxxxxxx ) { ... ; } | * catch( e ) { | ||
* | * if ( e.number == -xxxxxxxxxx ) { ... ; } | ||
* | * else { ... ; } | ||
* } | |||
* のように列記して処理を分岐させてもよい。 | |||
* | * | ||
* ・Alert() | * ・Alert(e); だけ記述しておいて、エラーダイアログだけは出して | ||
* | * マクロを終了させてもよい(ソースファイルを開かせない)。 | ||
* ・Quit() だけ記述しておいて、エラーダイアログなしで | * ・Quit(); だけ記述しておいて、エラーダイアログなしで | ||
* マクロを終了させてもよい。 | * マクロを終了させてもよい。 | ||
* ・セミコロンだけおいて {;} とすれば、エラーを無視して | * ・セミコロンだけおいて {;} とすれば、エラーを無視して | ||
* catch(e) {;} | * catch(e) {;} ブロックよりうしろのコードを処理させることもできる。 | ||
*/ ; | */ ; | ||
} | } | ||
| 447行目: | 455行目: | ||
* 例外が発生してもしなくても処理されるコード | * 例外が発生してもしなくても処理されるコード | ||
* (例外が発生したときは catch ブロックの後に実行される) | * (例外が発生したときは catch ブロックの後に実行される) | ||
* ※ finally{} ブロックはまるごと省略可 | * ※ finally { ... } ブロックはまるごと省略可 | ||
* | * | ||
* Scripting.FileSystemObject や ADODB.Stream でファイルを開いている場合は | * Scripting.FileSystemObject や ADODB.Stream でファイルを開いている場合は | ||
* ここでリソースを解放してやるとよい。 | * ここでリソースを解放してやるとよい。 | ||
* | * | ||
* try ... catch | * try ... catch 文を関数ブロック function(){ ... } 内においている場合は | ||
* return piyo; | * return piyo; | ||
* などで戻り値を返してやってもよい。 | * などで戻り値を返してやってもよい。 | ||
| 466行目: | 474行目: | ||
* try ... catch 文のあとのコードも処理される | * try ... catch 文のあとのコードも処理される | ||
*/ ; | */ ; | ||
</source> | |||
<source lang="javascript"> | |||
// テスト | |||
try{ | |||
hoge; | |||
} catch(e) { | |||
Alert(e); // 「TypeError: 'hoge' は宣言されていません。」 | |||
} | |||
Status="Test"; | |||
</source> | </source> | ||
| 477行目: | 494行目: | ||
: ※「表示座標(表示行)」ベースでの動作テストはほとんどしていません。 | : ※「表示座標(表示行)」ベースでの動作テストはほとんどしていません。 | ||
* ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。 | * ソースコード内ではしばしば unicode 文字を使用していますので、マクロの JS ファイルは UTF-8 形式で保存する前提となっています。 | ||
* ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ]]」マクロを利用しやすいように(個人的にタグジャンプ系のマクロに馴染めないので)、マクロのコードには半角空白を多用しています。 | * ソースコード内の変数名の検索などで「[[ポップアップメニューで検索先にジャンプ|検索ジャンプ]]」マクロを利用しやすいように(個人的にタグジャンプ系のマクロに馴染めないので)、マクロのコードには半角空白を多用しています。 | ||
* 基本的に、変数名は頭文字が小文字の camelCase に、関数名は頭文字が大文字の TitleCase にしてあります。 | * 基本的に、変数名は頭文字が小文字の camelCase に、関数名は頭文字が大文字の TitleCase にしてあります。 | ||
<br> | <br> | ||
スポンサーリンク