編集の要約なし |
編集の要約なし |
||
| 117行目: | 117行目: | ||
<br> | <br> | ||
拙作マクロはポップアップメニューを利用するものが多いので、Tips はその分野の内容に偏ってしまいますが…。 | 拙作マクロはポップアップメニューを利用するものが多いので、Tips はその分野の内容に偏ってしまいますが…。 | ||
== アイコン化したマクロ == | == アイコン化したマクロ == | ||
| 124行目: | 125行目: | ||
<br><br> | <br><br> | ||
マクロをツールバー/マクロバーから使用するために [[マテリアルデザインっぽいアイコンと『小マクロ集』|アイコン]] を作ったり、マクロバーにアイコンを詰め込むために [[#スクショ|試行錯誤]] したりも…。 | マクロをツールバー/マクロバーから使用するために [[マテリアルデザインっぽいアイコンと『小マクロ集』|アイコン]] を作ったり、マクロバーにアイコンを詰め込むために [[#スクショ|試行錯誤]] したりも…。 | ||
== ポップアップメニュー == | == ポップアップメニュー == | ||
| 144行目: | 146行目: | ||
var num = menu.Track( mePosMouse ); | var num = menu.Track( mePosMouse ); | ||
</source> | </source> | ||
=== アクセラレータ === | === アクセラレータ === | ||
| 174行目: | 177行目: | ||
var ret = menu.Track(); | var ret = menu.Track(); | ||
</source> | </source> | ||
=== ラベルの整形 === | === ラベルの整形 === | ||
| 222行目: | 226行目: | ||
// ※ 連番が多い場合は「番号を空白文字でケタ埋め (右端揃え)」などの処理も追加するとよい | // ※ 連番が多い場合は「番号を空白文字でケタ埋め (右端揃え)」などの処理も追加するとよい | ||
</source> | </source> | ||
=== 配列からポップアップメニューを生成 === | === 配列からポップアップメニューを生成 === | ||
| 245行目: | 250行目: | ||
} | } | ||
</source> | </source> | ||
=== サブメニュー === | === サブメニュー === | ||
| 253行目: | 259行目: | ||
: サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように PopupMenu.AddPopup() 周りを if() 文で囲うしかない。 | : サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように PopupMenu.AddPopup() 周りを if() 文で囲うしかない。 | ||
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。 | : 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。 | ||
=== マクロの動作設定を変更可能にする === | === マクロの動作設定を変更可能にする === | ||
| 266行目: | 273行目: | ||
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | : 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。 | ||
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。 | : ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。 | ||
== 選択範囲の 先頭位置/末尾位置 == | == 選択範囲の 先頭位置/末尾位置 == | ||
選択範囲の 開始(キャレットなし)/終了(キャレットあり) の位置は [[マクロリファレンス:Selection インターフェイス#GetAnchorPos メソッド|Selection.GetAnchorPos()]] と [[マクロリファレンス:Selection インターフェイス#GetActivePos メソッド|Selection.GetActivePos()]] とで取得できるが、先頭/末尾 の位置はそれらをもとにして前後関係を割りだす必要がある。 | 選択範囲の 開始(キャレットなし)/終了(キャレットあり) の位置は [[マクロリファレンス:Selection インターフェイス#GetAnchorPos メソッド|Selection.GetAnchorPos()]] と [[マクロリファレンス:Selection インターフェイス#GetActivePos メソッド|Selection.GetActivePos()]] とで取得できるが、先頭/末尾 の位置はそれらをもとにして前後関係を割りだす必要がある。 | ||
<br> | |||
※ GetTopPos() や GetBottomPos() というメソッドはない。 <br> | |||
<source lang="javascript"> | <source lang="javascript"> | ||
var ancPos, actPos, topPos, endPos; | var ancPos, actPos, topPos, endPos; | ||
| 278行目: | 288行目: | ||
endPos = Math.max( ancPos, actPos ); // 選択範囲の末尾位置 | endPos = Math.max( ancPos, actPos ); // 選択範囲の末尾位置 | ||
// topPos と endPos | // topPos と endPos の取得は以下のような記述方法でも可 | ||
topPos = ( ancPos < actPos ) ? ancPos : actPos; | topPos = ( ancPos < actPos ) ? ancPos : actPos; | ||
endPos = ( ancPos < actPos ) ? actPos : ancPos; | endPos = ( ancPos < actPos ) ? actPos : ancPos; | ||
</source> | </source> | ||
== [[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Collapse()]] メソッドとキャレット位置 == | |||
Selection.Collapse() メソッド で引数 meCollapseEnd を指定した場合は | |||
Selection.SetActivePos( Selection.GetActivePos() ) | |||
meCollapseStart を指定した場合は | |||
Selection.SetActivePos( Selection.SetAnchorPos() ) | |||
と意味的には同じである。 | |||
<br><br> | |||
※ 引数を省略した場合は meCollapseStart として動作する。<br> | |||
※ meCollapseStart / meCollapseEnd はそれぞれ「選択開始位置」と「選択終了位置 (キャレット位置)」を指し、「選択範囲の 先頭 / 末尾」ではない。<br> | |||
※ [[マクロリファレンス:Selection インターフェイス#SelectLine メソッド|Selection.SelectLine()]] や [[マクロリファレンス:Selection インターフェイス#SelectWord メソッド|Selection.SelectWord()]] などでの範囲選択では「キャレット位置=選択範囲の末尾」となり、[[マクロリファレンス:Selection インターフェイス#Find メソッド|Selection.Find()]] や [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|Selection.FindRepeat()]] での範囲選択では「キャレット位置=選択範囲の先頭」なので、つづけて Collapse() メソッドを使用するする場合には注意が必要。 | |||
<br><br> | |||
== [[マクロリファレンス:Selection インターフェイス#Find メソッド|Find()]] メソッドと [[マクロリファレンス:Selection インターフェイス#FindRepeat メソッド|FindRepeat()]] メソッドの [https://github.com/haijinboys/mery-plugin-sdk/blob/master/SDK/C/Basic/plugin.h 定数] == | |||
document.selection.'''Find()''' メソッド | |||
指定のパターンを検索します。 | |||
 0: meFindPrevious カーソル位置から前を検索します。 | |||
 1: meFindNext カーソル位置から次を検索します。 | |||
 2: meFindReplaceCase 検索する単語の大文字と小文字を区別します。 | |||
 4: meFindReplaceOnlyWord 完全に一致する単語を検索します。 | |||
 8: meFindAround 文書の末尾まで検索したら先頭から検索を開始します。 | |||
16: meFindReplaceRegExp 正規表現で検索します。 | |||
※ meFindReplaceOnlyWord と meFindReplaceRegExp は排他関係なので、同時に使用した場合 meFindReplaceRegExp は適用されるが meFindReplaceOnlyWord は無視される | |||
(検索ダイアログで「正規表現」オプションを有効化したときに「単語のみ」オプションが無効になるのと同様)。 | |||
document.selection.'''FindRepeat()''' メソッド | |||
前回検索した文字列を検索します。 | |||
 0: meFindPrevious カーソル位置から前を検索します。 | |||
 1: meFindNext カーソル位置から次を検索します。 | |||
 2: meFindRepeatWord 選択範囲が空の場合はカーソル位置の単語を検索します。 | |||
FindRepeat() メソッドでは定数 meFindReplaceCase や meFindReplaceOnlyWord , meFindAround , meFindReplaceRegExp が使用できないが、直前の「検索/置換」コマンドや Find() / Replace() メソッドで使用したこれらのオプションのうち meFindReplaceRegExp 以外の三つの ON/OFF 状態が継承される。 | |||
<br><br> | |||
よって、FindRepeat() メソッドで meFindReplaceCase や meFindReplaceOnlyWord , meFindAround を適用した検索をしたいばあいは、以下のように記述する。<br> | |||
※ meFindReplaceRegExp があっても FindRepeat() の実行時には無視される。 | |||
<source lang="javascript"> | |||
// 空文字列の検索をして、任意のオプションフラグだけ設定する | |||
document.selection.Find( "", meFindNext | |||
+ meFindReplaceCase + meFindReplaceOnlyWord + meFindAround ); | |||
// 前回検索した文字列を検索 | |||
document.selection.FindRepeat( meFindNext + meFindRepeatWord ); | |||
</source> | |||
== スクロール位置の調整 == | == スクロール位置の調整 == | ||
| 305行目: | 363行目: | ||
// ※ ScrollY プロパティに値を代入するときは物理座標(表示行)の行番号で | // ※ ScrollY プロパティに値を代入するときは物理座標(表示行)の行番号で | ||
</source> | </source> | ||
== カレントディレクトリ == | == カレントディレクトリ == | ||
| 331行目: | 390行目: | ||
} | } | ||
</source> | </source> | ||
== 動作要件としてのバージョンチェック == | == 動作要件としてのバージョンチェック == | ||
公開するマクロに Mery | 公開するマクロに Mery ベータ版で追加されたマクロ用プロパティ・定数を利用する場合は、マクロの動作要件として Mery 本体のバージョンをチェックするコードを入れておくのが無難である。 | ||
<br> | <br> | ||
* 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> | |||
* 専用の組み込み関数 [[Mery本体のバージョンチェック|VersionCheck()]] を利用すれば、Mery のバージョン番号を指定して動作要件のチェックができる。 | |||
: ※ あらかじめ、プロパティや定数が導入された Mery のバージョン番号を調べておく必要がある( → Mery.txt に記載されているはず)。 | |||
<source lang="javascript"> | |||
// ▼ ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降 | |||
if ( document.Selection.IsEmpty ) { | |||
document.selection.SelectLine(); // とりあえず行を範囲選択 | |||
} | |||
// 例1. VersionCheck() 関数を利用する場合 | |||
if ( VersionCheck( "2.6.10" ) ) { | |||
// 「単語の最初の文字を大文字に変換」 | |||
document.selection.ChangeCase( meCaseCapitalize ); | |||
} | |||
else { | |||
// 「小文字に変換」 | |||
document.selection.ChangeCase( meCaseLowerCase ); | |||
Status = "小文字で許せ。"; | |||
} | |||
// 例2. 定数が定義されているかを調べる場合 | |||
if ( typeof meCaseCapitalize == "number" ) { // または meCaseCapitalize==3 | |||
// 「単語の最初の文字を大文字に変換」 | |||
document.selection.ChangeCase( meCaseCapitalize ); | |||
} | |||
else { | |||
// ExecuteCommandByID() で「単語の最初の文字を大文字に変換」 | |||
editor.ExecuteCommandByID( MEID_EDIT_CAPITALIZE = 2116 ); | |||
} | |||
</source> | |||
<source lang="javascript"> | |||
// ▼ BeginUndoGroup() メソッドを使えるのは ver 2.7.0 以降 | |||
// 例3. VersionCheck() 関数を利用する場合 | |||
if ( VersionCheck( "2.7.0" ) ) { | |||
BeginUndoGroup(); | |||
} | |||
// 例4. メソッドが定義されているかを調べる場合 | |||
if ( "BeginUndoGroup" in window ) { | |||
BeginUndoGroup(); | |||
} | |||
</source> | |||
== 外部リソースのチェック == | == 外部リソースのチェック == | ||
「include ライブラリ」や「GetKeyState.exe」のような外部リソースを必要とする前提のマクロでも、それらのリソースがない環境でもある程度マクロが動くようにコーディングすることもできる。 | |||
<br><br> | |||
* [[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | * [[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | ||
: ユーザー側で include ライブラリが導入されていて、マクロ側で | : ユーザー側で include ライブラリが導入されていて、マクロ側で | ||
| 374行目: | 484行目: | ||
} | } | ||
</source> | </source> | ||
== Mery.ini から設定値を取得する == | == Mery.ini から設定値を取得する == | ||
| 395行目: | 506行目: | ||
「現在の表示状態」を取得してから ON/OFF を指定しての切り替えを行なうためには、include ライブラリの IO クラスを利用するなどして外部に Mery.ini とは別の設定ファイル (e.g. JSON ファイル) を用意して、切り替え実行のたびに設定ファイルを読み書きする必要がある。<br> | 「現在の表示状態」を取得してから ON/OFF を指定しての切り替えを行なうためには、include ライブラリの IO クラスを利用するなどして外部に Mery.ini とは別の設定ファイル (e.g. JSON ファイル) を用意して、切り替え実行のたびに設定ファイルを読み書きする必要がある。<br> | ||
※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。 | ※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。 | ||
<br><br> | |||
== 警告・確認ダイアログとステータスバーの使い分け == | == 警告・確認ダイアログとステータスバーの使い分け == | ||
| 404行目: | 516行目: | ||
また、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> | |||
== エラー処理 == | == エラー処理 == | ||
| 484行目: | 597行目: | ||
Status="Test"; | Status="Test"; | ||
</source> | </source> | ||
== その他、拙作マクロについて == | == その他、拙作マクロについて == | ||
スポンサーリンク