編集の要約なし |
編集の要約なし |
||
| 151行目: | 151行目: | ||
ポップアップメニューのラベルの文字列に「半角アンパサンド記号('''&''') + 半角英数字 (またはアスキー記号)」を付記することで、アクセラレータ(アクセスキー)を設定することができる。<br> | ポップアップメニューのラベルの文字列に「半角アンパサンド記号('''&''') + 半角英数字 (またはアスキー記号)」を付記することで、アクセラレータ(アクセスキー)を設定することができる。<br> | ||
ラベルの先頭に連番数字などがある場合は、アンパサンド記号を付加することで、数字をアクセラレータにするとよい。<br> | ラベルの先頭に連番数字などがある場合は、アンパサンド記号を付加することで、数字をアクセラレータにするとよい。<br> | ||
そのさい、Shift キー付きでの入力が必要な記号は Shift キーなしで入力可能なキーのラベルと同一視される (e.g. &# | そのさい、Shift キー付きでの入力が必要な記号は Shift キーなしで入力可能なキーのラベルと同一視される (e.g. 「&#」で "'''#'''" 記号をアクセラレータに指定した場合、JIS 配列のキーボードでは ['''2'''] キーがアクセラレータになる)。<br> | ||
また、「& 」(半角アンパサンド+半角空白) で半角スペースをアクセラレータに指定したアイテムは、スペースキーがアクセスキーになる。 | |||
* <span style="color:#c00;">"'''&'''" 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の "'''&'''" | * <span style="color:#c00;">"'''&'''" 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の "'''&'''" 記号のうしろの文字がアクセラレータになる</u></span>( … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある)。 | ||
* <span style="color:#c00;">全角文字はアクセラレータにできない。</span> | * <span style="color:#c00;">全角文字はアクセラレータにできない。</span> | ||
* <span style="color:#c00;">ラベル文字列に含まれる "'''&'''" | * <span style="color:#c00;">ラベル文字列に含まれる "'''&'''" 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに "'''&'''" 記号を表示させたいときは、"'''&&'''" のように二重に記述する必要がある。</span><br> → 不特定の文字列をラベルにする場合は、あらかじめ String.replace( /&/g, "&&" ) と記述するとよい。 | ||
* <span style="color:#c00;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(→ [Enter] キーで決定する)。</span> | * <span style="color:#c00;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(→ [Enter] キーで決定する)。</span> | ||
<source lang="javascript"> | <source lang="javascript"> | ||
| 165行目: | 165行目: | ||
menu.Add( "アイテム&2", 2 ); // [2] キーがアクセラレータ | menu.Add( "アイテム&2", 2 ); // [2] キーがアクセラレータ | ||
menu.Add( "0&3 アイテム3", 3 ); // [3] キーがアクセラレータ | menu.Add( "0&3 アイテム3", 3 ); // [3] キーがアクセラレータ | ||
menu.Add( "&Hello World &4", 4 ); // [H] キーがアクセラレータ | menu.Add( "&Hello &World &4", 4 ); // [H] キーがアクセラレータ | ||
menu.Add( piyo.replace( /&/g, "&&" ) + "(&5)", 5 ); // [5] キーがアクセラレータ | menu.Add( piyo.replace( /&/g, "&&" ) + "(&5)", 5 ); // [5] キーがアクセラレータ | ||
menu.Add( piyo + "(&6)", 6 ); // スペースキーがアクセラレータ | menu.Add( piyo + "(&6)", 6 ); // スペースキーがアクセラレータ | ||
| 270行目: | 270行目: | ||
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。 | : 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。 | ||
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読みなおす・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。 | * sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読みなおす・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。 | ||
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の | : これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serialize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。 | ||
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | : 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | ||
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。 | : ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。 | ||
| 294行目: | 294行目: | ||
== [[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Collapse()]] | == [[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Collapse() メソッド]] とキャレット位置 == | ||
Selection.Collapse() メソッド で引数 meCollapseEnd を指定した場合は | Selection.Collapse() メソッド で引数 ''meCollapseEnd'' を指定した場合は | ||
Selection.SetActivePos( Selection.GetActivePos() ) | Selection.SetActivePos( Selection.GetActivePos() ) | ||
meCollapseStart を指定した場合は | ''meCollapseStart'' を指定した場合は | ||
Selection.SetActivePos( Selection.SetAnchorPos() ) | Selection.SetActivePos( Selection.SetAnchorPos() ) | ||
と意味的には同じである。 | と意味的には同じである。 | ||
<br><br> | <br><br> | ||
※ 引数を省略した場合は meCollapseStart として動作する。<br> | ※ 引数を省略した場合は ''meCollapseStart'' として動作する。<br> | ||
※ meCollapseStart / meCollapseEnd はそれぞれ「選択開始位置」と「選択終了位置 (キャレット位置)」を指し、「選択範囲の 先頭 / 末尾」ではない。<br> | ※ ''meCollapseStart / meCollapseEnd'' はそれぞれ「選択開始位置」と「選択終了位置 (キャレット位置)」を指し、「選択範囲の 先頭 / 末尾」ではない。<br> | ||
※ [[マクロリファレンス:Selection インターフェイス#SelectLine メソッド|Selection.SelectLine()]] や [[マクロリファレンス:Selection インターフェイス#SelectWord メソッド|Selection.SelectWord()]] などでの範囲選択では「キャレット位置=選択範囲の末尾」となり、[[マクロリファレンス:Selection インターフェイス#Find メソッド|Selection.Find()]] や [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|Selection.FindRepeat()]] での範囲選択では「キャレット位置=選択範囲の先頭」なので、つづけて Collapse() メソッドを使用するする場合には注意が必要。 | ※ [[マクロリファレンス:Selection インターフェイス#SelectLine メソッド|Selection.SelectLine()]] や [[マクロリファレンス:Selection インターフェイス#SelectWord メソッド|Selection.SelectWord()]] などでの範囲選択では「キャレット位置=選択範囲の末尾」となり、[[マクロリファレンス:Selection インターフェイス#Find メソッド|Selection.Find()]] や [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|Selection.FindRepeat()]] での範囲選択では「キャレット位置=選択範囲の先頭」なので、つづけて Collapse() メソッドを使用するする場合には注意が必要。 | ||
<br><br> | <br><br> | ||
== [[マクロリファレンス:Selection インターフェイス#Find メソッド|Find()]] | == [[マクロリファレンス:Selection インターフェイス#Find メソッド|Find() メソッド]] と [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|FindRepeat() メソッド]] の [https://github.com/haijinboys/mery-plugin-sdk/blob/master/SDK/C/Basic/plugin.h 定数] == | ||
<br> | <br> | ||
; Find() メソッド | ; Find() メソッド | ||
| 355行目: | 355行目: | ||
== スクロール位置の調整 == | == スクロール位置の調整 == | ||
キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動した行数がエディタの表示領域の高さに収まるかどうか(スクロールマージンの考慮が必要)とジャンプ方向によるので安定的ではない。<br> | キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動した行数がエディタの表示領域の高さに収まるかどうか(スクロールマージンの考慮が必要)とジャンプ方向によるので安定的ではない。<br> | ||
以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の [[マクロリファレンス:Window インターフェイス#ScrollY プロパティ| | 以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の [[マクロリファレンス:Window インターフェイス#ScrollY プロパティ|先頭位置(window.ScrollY)]] になるように調整するもの。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
var s = Document.Selection; | var s = Document.Selection; | ||
| 409行目: | 409行目: | ||
* JavaScript には特定のプロパティがオブジェクト配下に定義されているかを調べる方法も色々とあるが、親オブジェクトのタイプやプロパティ・定数のタイプ、JavaScript(JScript)のバージョンによる互換性などへの考慮が必要になる。 [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/typeof][https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/in][https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty] | * JavaScript には特定のプロパティがオブジェクト配下に定義されているかを調べる方法も色々とあるが、親オブジェクトのタイプやプロパティ・定数のタイプ、JavaScript(JScript)のバージョンによる互換性などへの考慮が必要になる。 [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/typeof][https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/in][https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty] | ||
<br> | <br> | ||
* | * 専用の '''組み込み関数''' [[Mery本体のバージョンチェック|VersionCheck()]] を利用すれば、Mery のバージョン番号を指定して動作要件のチェックができる。 | ||
: ※ あらかじめ、プロパティや定数が導入された Mery のバージョン番号を調べておく必要がある( | : ※ あらかじめ、プロパティや定数が導入された Mery のバージョン番号を調べておく必要がある( ← Mery.txt に記載されているはず)。 | ||
<source lang="javascript"> | <source lang="javascript"> | ||
// ▼ ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降 | // ▼ ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降 | ||
| 427行目: | 427行目: | ||
document.selection.ChangeCase( meCaseLowerCase ); | document.selection.ChangeCase( meCaseLowerCase ); | ||
Status = "小文字で許せ。"; | Status = "小文字で許せ。"; | ||
} | |||
function VersionCheck( versionStr ) { | |||
/* 関数のコードをコピペ */ ; | |||
} | } | ||
| 446行目: | 450行目: | ||
if ( VersionCheck( "2.7.0" ) ) { | if ( VersionCheck( "2.7.0" ) ) { | ||
BeginUndoGroup(); | BeginUndoGroup(); | ||
} | |||
function VersionCheck( versionStr ) { | |||
/* 関数のコードをコピペ */ ; | |||
} | } | ||
| 504行目: | 512行目: | ||
* 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 ファイルの読み込みを1回におさえられる)。 | ただし、制約がない代わりに組み込み関数自体のコードが長いことや、引数や戻り値が配列であることでコードが煩雑にならざるをえない( ⇔ 配列を使用することで、複数の項目を取得する場合でも Mery.ini ファイルの読み込みを1回におさえられる)。 | ||
<br><br> | <br><br> | ||
| 521行目: | 529行目: | ||
== 警告・確認ダイアログとステータスバーの使い分け == | == 警告・確認ダイアログとステータスバーの使い分け == | ||
マクロからユーザーにメッセージを与える手段として [[マクロリファレンス:Window インターフェイス#Alert メソッド| | マクロからユーザーにメッセージを与える手段として [[マクロリファレンス:Window インターフェイス#Alert メソッド|警告(window.Alert)]]・[[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認(window.Confirm)]]ダイアログと [[マクロリファレンス:Window インターフェイス#Status プロパティ|ステータスバー(window.Status)]]への表示などがある(ほかに [[マクロリファレンス:OutputBar インターフェイス#Write メソッド|アウトプットバー(OutputBar.Write)]]やポップアップメニューを使う方法もある)。<br> | ||
Mery のマクロで利用できるポップアップダイアログは、両方ともサウンドをともない、ボタン操作で閉じるまで作業を中断させてしまうので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | Mery のマクロで利用できるポップアップダイアログは、両方ともサウンドをともない、ボタン操作で閉じるまで作業を中断させてしまうので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | ||
<br> | <br> | ||
| 527行目: | 535行目: | ||
<br><br> | <br><br> | ||
また、Mery の Window クラスのメソッド・プロパティを使うほかにも、WSH の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364428(v=msdn.10) WshShell.Popup メソッド] によるメッセージボックス利用することもできる。<br> | また、Mery の Window クラスのメソッド・プロパティを使うほかにも、WSH の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364428(v=msdn.10) WshShell.Popup メソッド] によるメッセージボックス利用することもできる。<br> | ||
ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、[はい], [いいえ], [キャンセル] の3ボタンが必要な場合でもなければお勧めはしない…。 | ダイアログ内の左側のアイコンや [OK], [キャンセル], [はい], [いいえ] などのボタンの種類をカスタマイズでき、指定時間の経過後に自動で閉じさせることもできるが、引数の指定や戻り値の処理が煩雑なので、[はい], [いいえ], [キャンセル] の3ボタンが必要な場合でもなければお勧めはしない…。<br> | ||
※ アイコンなしにすれば、システムのサウンドなしでダイアログを表示できる。 | |||
<br><br> | <br><br> | ||
== エラー処理 == | == エラー処理 == | ||
Mery | Mery のマクロで例外(エラー)が発生した場合、ダイアログのポップアップにより中断される。<br> | ||
マクロの開発者側にとってはソースファイル内の例外が発生した行に速やかにアクセスできるので便利ではあるが、コードを読むのに不慣れなユーザーにおいてはソースコードを開いたところで何が解決するわけでもない。<br> | マクロの開発者側にとってはソースファイル内の例外が発生した行に速やかにアクセスできるので便利ではあるが、コードを読むのに不慣れなユーザーにおいてはソースコードを開いたところで何が解決するわけでもない。<br> | ||
エラーダイアログは自家用の自作マクロのメンテナンスのさいには有用であるが、公開用のマクロの場合はユーザーがソースコードに誤った改変を加えてしまう惧れもあるので、基本的に必要性がないといえる。 | |||
<br><br> | |||
※ wshShell.Run( "実在しない実行ファイル.exe /間違ったパラメータ" ); のようなコードの場合でも、Mery.exe のエラーとして扱われる。 | |||
<br><br> | <br><br> | ||
例外が発生することを予期できたり、例外が発生してもそれを無視してマクロの実行を継続したり回避用の処理に移行させられる場合は、JavaScript の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Exception_Handling_Statements/try...catch_Statement try...catch 文] を組み込むとよい。 | 例外が発生することを予期できたり、例外が発生してもそれを無視してマクロの実行を継続したり回避用の処理に移行させられる場合は、JavaScript の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Exception_Handling_Statements/try...catch_Statement try...catch 文] を組み込むとよい。 | ||
| 587行目: | 598行目: | ||
* try ... catch 文を関数ブロック function(){ ... } 内においている場合は | * try ... catch 文を関数ブロック function(){ ... } 内においている場合は | ||
* return piyo; | * return piyo; | ||
* | * などで、なんらかの戻り値を返してやってもよい。 | ||
* | * | ||
* ※ catch ブロックで Quit(); や return ***; を記述している場合は | * ※ catch ブロックで Quit(); や return ***; を記述している場合は | ||
| 605行目: | 616行目: | ||
hoge; | hoge; | ||
} catch(e) { | } catch(e) { | ||
Alert(e); | Status = e.message; // 「'hoge' は宣言されていません。」 | ||
Alert(e); // 「TypeError: 'hoge' は宣言されていません。」 | |||
} | } | ||
Status="Test"; | Status = "Error Test"; | ||
</source> | </source> | ||
| 631行目: | 643行目: | ||
= 投稿した[[構文ファイル]] = | = 投稿した [[構文ファイル]] = | ||
* [[Mery MSY]] (uploaded: 2018/09/05) | * [[Mery MSY]] (uploaded: 2018/09/05) | ||
| 649行目: | 661行目: | ||
マクロバー (1段目) にアイコンを詰めこむための sukemaru の試行錯誤の遍歴... | マクロバー (1段目) にアイコンを詰めこむための sukemaru の試行錯誤の遍歴... | ||
* '''共通''' | * '''共通''' | ||
: Windows XP (Classic テーマ) | : システム環境: Windows XP 32bit SP3 (Classic テーマ) | ||
: ウインドウサイズ (幅): 約 970 px | : ウインドウサイズ (幅): 約 970 px | ||
: アイコンサイズ: 中 (24px) | : アイコンサイズ: 中 (24px) | ||
スポンサーリンク