編集の要約なし |
非推奨のタグを修正 |
||
| 149行目: | 149行目: | ||
メインコードの途中に短い [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/function 関数] を置く場合は、最初の呼び出しコードより前に変数([https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/function 関数式])として定義しておいてもよい。 | メインコードの途中に短い [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Statements/function 関数] を置く場合は、最初の呼び出しコードより前に変数([https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Operators/function 関数式])として定義しておいてもよい。 | ||
< | <syntaxhighlight lang="javascript"> | ||
{ | { | ||
var hoge = "hogehoge"; | var hoge = "hogehoge"; | ||
| 160行目: | 160行目: | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
ならば、以下のような記述でも同じ意味 (ただし、関数式の場合は、最初に呼び出す文よりも前に定義しておくこと)。 | ならば、以下のような記述でも同じ意味 (ただし、関数式の場合は、最初に呼び出す文よりも前に定義しておくこと)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// 関数式は最初に呼び出されるよりも前に定義すること | // 関数式は最初に呼び出されるよりも前に定義すること | ||
var HogeFuga = function( str ) { | var HogeFuga = function( str ) { | ||
| 170行目: | 170行目: | ||
document.selection.Text = HogeFuga( hoge ); | document.selection.Text = HogeFuga( hoge ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== メタ記号をエスケープする === | === メタ記号をエスケープする === | ||
任意の文字列を正規表現変数 < | 任意の文字列を正規表現変数 <syntaxhighlight lang="javascript" inline>RegExp()</syntaxhighlight> におさめる前などにエスケープ(退避修飾)する。 | ||
<br><br> | <br><br> | ||
* '''正規表現のメタ記号のみ''' をエスケープする方法。<br> | * '''正規表現のメタ記号のみ''' をエスケープする方法。<br> | ||
: ※ ref. 『[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Regular_Expressions#Escaping 正規表現 - JavaScript | MDN]』 | : ※ ref. 『[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Regular_Expressions#Escaping 正規表現 - JavaScript | MDN]』 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 RegQuote( str ) | * 関数 RegQuote( str ) | ||
| 190行目: | 190行目: | ||
return str.replace( /[.*+?^=!:${}()|[\]\/\\]/g, "\\$&" ); | return str.replace( /[.*+?^=!:${}()|[\]\/\\]/g, "\\$&" ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
* または、記述の簡単な方法(ただし、<q>処理対象の文字列が長大</q> な場合や <q>日本語テキスト</q> の場合には適さない)。 | * または、記述の簡単な方法(ただし、<q>処理対象の文字列が長大</q> な場合や <q>日本語テキスト</q> の場合には適さない)。 | ||
: ※ ref. 『[https://ja.wikibooks.org/wiki/JavaScript/%E6%AD%A3%E8%A6%8F%E8%A1%A8%E7%8F%BE#RegExp JavaScript/正規表現 - Wikibooks]』 | : ※ ref. 『[https://ja.wikibooks.org/wiki/JavaScript/%E6%AD%A3%E8%A6%8F%E8%A1%A8%E7%8F%BE#RegExp JavaScript/正規表現 - Wikibooks]』 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 Quote( str ) | * 関数 Quote( str ) | ||
| 213行目: | 213行目: | ||
// } ); | // } ); | ||
// } | // } | ||
</ | </syntaxhighlight> | ||
: ※ JavaScript において <b style="color:#c00;"> $& </b> は "マッチした部分文字列全体" を意味する JavaScript ネイティブの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter 特殊変数]。<br> 置換関数 function() の引数がひとつの場合、その引数は <b style="color:#c00;"> $& </b> と同じ意味になるので、上の関数で '''$0''' と記述していることに特別な意味はない('''tmp''' や '''str'''、'''chr''' など任意の文字列でもよい)。 | : ※ JavaScript において <b style="color:#c00;"> $& </b> は "マッチした部分文字列全体" を意味する JavaScript ネイティブの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter 特殊変数]。<br> 置換関数 function() の引数がひとつの場合、その引数は <b style="color:#c00;"> $& </b> と同じ意味になるので、上の関数で '''$0''' と記述していることに特別な意味はない('''tmp''' や '''str'''、'''chr''' など任意の文字列でもよい)。 | ||
: ※ 後述、[[#関数の「呼び出しコスト」|関数の「呼び出しコスト」]] の項に書いているように、上出のふたつの < | : ※ 後述、[[#関数の「呼び出しコスト」|関数の「呼び出しコスト」]] の項に書いているように、上出のふたつの <syntaxhighlight lang="javascript" inline>Quote( str )</syntaxhighlight> 関数の処理速度にはちがいが生じる。 | ||
<br><br> | <br><br> | ||
=== 数値を3ケタ区切り(カンマ区切り)にする === | === 数値を3ケタ区切り(カンマ区切り)にする === | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 SeparateNum( num ) | * 関数 SeparateNum( num ) | ||
| 231行目: | 231行目: | ||
return num.toString().replace( /(\d)(?=(?:\d{3})+(?!\d))/g, "$1," ); | return num.toString().replace( /(\d)(?=(?:\d{3})+(?!\d))/g, "$1," ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
小数、または半角数字を含む文字列の場合は | 小数、または半角数字を含む文字列の場合は | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 SeparateNum2( num ) | * 関数 SeparateNum2( num ) | ||
| 252行目: | 252行目: | ||
return a.join( "" ); | return a.join( "" ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== 数値を小数点以下3ケタの固定長にする === | === 数値を小数点以下3ケタの固定長にする === | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 NumFix( num ) | * 関数 NumFix( num ) | ||
| 278行目: | 278行目: | ||
// 対象が数値( Number 型)であれば toFixed() だけでよい | // 対象が数値( Number 型)であれば toFixed() だけでよい | ||
// num = num.toFixed( 3 ); | // num = num.toFixed( 3 ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
[[#TOP|>> 目次へ]] | [[#TOP|>> 目次へ]] | ||
| 286行目: | 286行目: | ||
※ 引数の型に応じた関数を使用する。 | ※ 引数の型に応じた関数を使用する。 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 Pad( num ) | * 関数 Pad( num ) | ||
| 297行目: | 297行目: | ||
return num < 10 ? "0" + num : num; | return num < 10 ? "0" + num : num; | ||
} | } | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 Pad2( str ) | * 関数 Pad2( str ) | ||
| 311行目: | 311行目: | ||
} ); | } ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 NumPad2( val ) | * 関数 NumPad2( val ) | ||
| 324行目: | 324行目: | ||
} ); | } ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== 任意の文字列のくりかえしで埋める === | === 任意の文字列のくりかえしで埋める === | ||
※ Windows XP 用 | ※ Windows XP 用 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 Repeat( str, count ) | * 関数 Repeat( str, count ) | ||
| 343行目: | 343行目: | ||
return ret; | return ret; | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== ascii 文字に対応する全角英数記号を半角変換 / 数値専用の入力ダイアログ === | === ascii 文字に対応する全角英数記号を半角変換 / 数値専用の入力ダイアログ === | ||
※ IME: ON の状態で入力された「全角数字」も許容、「全角/半角の数字」以外の文字列は無視する入力ダイアログのサンプルコード | ※ IME: ON の状態で入力された「全角数字」も許容、「全角/半角の数字」以外の文字列は無視する入力ダイアログのサンプルコード | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 関数 ToHalfWidth( str ) | * 関数 ToHalfWidth( str ) | ||
| 377行目: | 377行目: | ||
if ( ! p ) { Status = "キャンセル"; } | if ( ! p ) { Status = "キャンセル"; } | ||
else { Alert( p ); } | else { Alert( p ); } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== ストップウォッチ・タイマー === | === ストップウォッチ・タイマー === | ||
< | <syntaxhighlight lang="javascript"> | ||
// 計測開始 ※ ソースコードの先頭付近におくこと | // 計測開始 ※ ソースコードの先頭付近におくこと | ||
var start = new Date(); | var start = new Date(); | ||
| 391行目: | 391行目: | ||
// ステータスバーに処理時間を表示 | // ステータスバーに処理時間を表示 | ||
Status = ( ( new Date() - start ) / 1000 ).toFixed( 3 ) + " 秒"; | Status = ( ( new Date() - start ) / 1000 ).toFixed( 3 ) + " 秒"; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== Mery のバージョン情報 === | === Mery のバージョン情報 === | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* Mery のバージョン情報 | * Mery のバージョン情報 | ||
| 403行目: | 403行目: | ||
+ editor.Version; | + editor.Version; | ||
Status = meryVersion; | Status = meryVersion; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 409行目: | 409行目: | ||
※ ref. 『[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392005%28v=msdn.10%29 ScriptEngine 関数 (JScript) | Microsoft Docs]』 | ※ ref. 『[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392005%28v=msdn.10%29 ScriptEngine 関数 (JScript) | Microsoft Docs]』 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* JavaScript (JScript) エンジンのバージョン情報 | * JavaScript (JScript) エンジンのバージョン情報 | ||
| 418行目: | 418行目: | ||
+ ScriptEngineBuildVersion(); | + ScriptEngineBuildVersion(); | ||
Status = engine; | Status = engine; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
[[#TOP|>> 目次へ]] | [[#TOP|>> 目次へ]] | ||
| 540行目: | 540行目: | ||
ポップアップメニューも表示されたが、実際に表示されていたアイテム数は 6000 件台で、20000 件以上のアイテムは表示されずにスポイルされてしまっていたということもあった。<br><br> | ポップアップメニューも表示されたが、実際に表示されていたアイテム数は 6000 件台で、20000 件以上のアイテムは表示されずにスポイルされてしまっていたということもあった。<br><br> | ||
以下の単純なコードでアイテム 10000 件のポップアップメニューを表示させようとしても、4000 件ぐらい(4000 前後で不定)までしか表示されない…。 | 以下の単純なコードでアイテム 10000 件のポップアップメニューを表示させようとしても、4000 件ぐらい(4000 前後で不定)までしか表示されない…。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var m = CreatePopupMenu(); | var m = CreatePopupMenu(); | ||
for ( var i = 1; i <= 10000; i ++ ) { | for ( var i = 1; i <= 10000; i ++ ) { | ||
| 546行目: | 546行目: | ||
} | } | ||
var r = m.Track( mePosMouse ); | var r = m.Track( mePosMouse ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
環境依存の不具合かもしれないが、はて…? | 環境依存の不具合かもしれないが、はて…? | ||
| 553行目: | 553行目: | ||
==== オプションフラグ ==== | ==== オプションフラグ ==== | ||
[[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] の第三引数 '''Flags''' : int を数値化すると | [[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] の第三引数 '''Flags''' : int を数値化すると | ||
< | <syntaxhighlight lang="javascript"> | ||
meMenuChecked = 1 | meMenuChecked = 1 | ||
meMenuGrayed = 2 | meMenuGrayed = 2 | ||
meMenuChecked + meMenuGrayed = 3 | meMenuChecked + meMenuGrayed = 3 | ||
meMenuSeparator = 4 | meMenuSeparator = 4 | ||
</ | </syntaxhighlight> | ||
となるので、真偽値が < | となるので、真偽値が <syntaxhighlight lang="javascript" inline>true=1</syntaxhighlight> / <syntaxhighlight lang="javascript" inline>false=0</syntaxhighlight> で評価されることを利用して、真偽値を返す変数や条件式を代入することができる(ただし Number 型に変換する必要がある ← 算術演算子 <syntaxhighlight lang="javascript" inline>+</syntaxhighlight> をつけるなど)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var menu = CreatePopupMenu(); | var menu = CreatePopupMenu(); | ||
var hoge = true; | var hoge = true; | ||
| 572行目: | 572行目: | ||
} | } | ||
var num = menu.Track( mePosMouse ); | var num = menu.Track( mePosMouse ); | ||
</ | </syntaxhighlight> | ||
: ※ オプションフラグ ''meMenuGrayed'' を使用して条件付きで特定の項目をグレーアウトするだけでなく、<code>menu.Add( ... );</code> の行を [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲むなどすれば、状況に応じたメニュー項目だけを表示させることもできる。 | : ※ オプションフラグ ''meMenuGrayed'' を使用して条件付きで特定の項目をグレーアウトするだけでなく、<code>menu.Add( ... );</code> の行を [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲むなどすれば、状況に応じたメニュー項目だけを表示させることもできる。 | ||
| 584行目: | 584行目: | ||
* <span style="color:#0000c0;">'''<q>&</q>''' 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の '''<q>&</q>''' 記号のうしろの文字がアクセラレータになる</u></span>( … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある)。 | * <span style="color:#0000c0;">'''<q>&</q>''' 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の '''<q>&</q>''' 記号のうしろの文字がアクセラレータになる</u></span>( … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある)。 | ||
* <span style="color:#c00;">全角文字はアクセラレータにできない。</span> | * <span style="color:#c00;">全角文字はアクセラレータにできない。</span> | ||
* <span style="color:#c00;">ラベル文字列に含まれる '''<q>&</q>''' 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに '''<q>&</q>''' 記号を表示させたいときは、'''<q>&&</q>''' のように二重に記述する必要がある。</span><br> → 不特定の文字列 < | * <span style="color:#c00;">ラベル文字列に含まれる '''<q>&</q>''' 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに '''<q>&</q>''' 記号を表示させたいときは、'''<q>&&</q>''' のように二重に記述する必要がある。</span><br> → 不特定の文字列 <syntaxhighlight lang="javascript" inline>String</syntaxhighlight> (文書内から抽出したテキストなど)をラベルにする場合は、あらかじめ <syntaxhighlight lang="javascript" inline>String.replace( /&/g, "&&" )</syntaxhighlight> と記述するとよい。 | ||
: ※ '''<q>&&</q>''' の記述で表示される '''<q>&</q>''' 記号は、アクセラレータにならない。 | : ※ '''<q>&&</q>''' の記述で表示される '''<q>&</q>''' 記号は、アクセラレータにならない。 | ||
* <span style="color:#0000c0;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(その場合は <kbd>Enter</kbd> キーで決定する)。</span><br> → アイテム数が多くなるメニューの場合、< | * <span style="color:#0000c0;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(その場合は <kbd>Enter</kbd> キーで決定する)。</span><br> → アイテム数が多くなるメニューの場合、<syntaxhighlight lang="javascript" inline>menu.Add( "キャンセル & ", 0 );</syntaxhighlight> という行を 10 件とか 20 件ごとに挿入すると、スペースキーでポップアップメニュー内をスクロールさせることができる。 | ||
: ※「'''&<span style="background:#bfdfff;"> </span>'''」(半角アンパサンド+半角空白) で半角スペースをアクセラレータに指定したアイテムは、<kbd>Space</kbd> キーがアクセスキーになる。 | : ※「'''&<span style="background:#bfdfff;"> </span>'''」(半角アンパサンド+半角空白) で半角スペースをアクセラレータに指定したアイテムは、<kbd>Space</kbd> キーがアクセスキーになる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
/* アクセラレータを付加する */ | /* アクセラレータを付加する */ | ||
| 609行目: | 609行目: | ||
var ret = menu.Track( 0 ); | var ret = menu.Track( 0 ); | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
/* 10 行ごとに「キャンセル」項目を挿入し、スペースキーでスクロール可能にする */ | /* 10 行ごとに「キャンセル」項目を挿入し、スペースキーでスクロール可能にする */ | ||
| 629行目: | 629行目: | ||
document.selection.SetActivePoint( mePosLogical, 1, y ); | document.selection.SetActivePoint( mePosLogical, 1, y ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 635行目: | 635行目: | ||
* 基本的にポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている @WinXP)。<br> | * 基本的にポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている @WinXP)。<br> | ||
: 文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。 | : 文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。 | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* ポップアップメニューに表示するラベルを整形する | * ポップアップメニューに表示するラベルを整形する | ||
| 688行目: | 688行目: | ||
var num = ( " " + y ).slice( - numWidth ).replace( /\d$/, "&$&" ); | var num = ( " " + y ).slice( - numWidth ).replace( /\d$/, "&$&" ); | ||
menuKey = num + ": " + menuKey; | menuKey = num + ": " + menuKey; | ||
</ | </syntaxhighlight> | ||
: ※ このコードでは色々と unicode 文字を使用しているので、マクロの JS ファイルは UTF-8 などの形式で保存しなければならない。 | : ※ このコードでは色々と unicode 文字を使用しているので、マクロの JS ファイルは UTF-8 などの形式で保存しなければならない。 | ||
<!-- | <!-- | ||
| 702行目: | 702行目: | ||
※ <code>PopupMenu.Track()</code> が発動した時点でエディタウインドウ本体は停止するので、直後に <syntaxhighlight lang="javascript" inline>Status = "hoge";</syntaxhighlight> を記述しても、ポップアップメニューの項目を選択するかメニューをキャンセルするまで表示されない。 | ※ <code>PopupMenu.Track()</code> が発動した時点でエディタウインドウ本体は停止するので、直後に <syntaxhighlight lang="javascript" inline>Status = "hoge";</syntaxhighlight> を記述しても、ポップアップメニューの項目を選択するかメニューをキャンセルするまで表示されない。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. ポップアップメニュー表示までのマクロの処理時間をステータス表示させる | // e.g. ポップアップメニュー表示までのマクロの処理時間をステータス表示させる | ||
| 728行目: | 728行目: | ||
document.selection.SetActivePoint( mePosLogical, 1, yy, false ); | document.selection.SetActivePoint( mePosLogical, 1, yy, false ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
: ※ ポップアップメニューにかぎらず、[[マクロリファレンス:Window インターフェイス#Alert メソッド|警告 (Alert)]] や [[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認 (Confirm)]]、 [[マクロリファレンス:Window インターフェイス#Prompt メソッド|入力 (Prompt)]] ダイアログなどモーダルなポップアップウインドウを表示させる場合も、同様に <syntaxhighlight lang="javascript" inline>Status = "hoge";</syntaxhighlight> を先に記述する必要がある。 | : ※ ポップアップメニューにかぎらず、[[マクロリファレンス:Window インターフェイス#Alert メソッド|警告 (Alert)]] や [[マクロリファレンス:Window インターフェイス#Confirm メソッド|確認 (Confirm)]]、 [[マクロリファレンス:Window インターフェイス#Prompt メソッド|入力 (Prompt)]] ダイアログなどモーダルなポップアップウインドウを表示させる場合も、同様に <syntaxhighlight lang="javascript" inline>Status = "hoge";</syntaxhighlight> を先に記述する必要がある。 | ||
| 738行目: | 738行目: | ||
==== 配列からポップアップメニューを生成 ==== | ==== 配列からポップアップメニューを生成 ==== | ||
[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/ ループ処理] によって配列からポップアップメニューのアイテムを生成する場合に、[[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] の第二引数 '''id''' (※通常は 1 ~ )と配列のアイテムのインデックス '''[ i ]''' の値(※通常は 0 ~ )を一致させたいときは、配列の先頭にダミーまたは空の要素を置いておき、ループ処理の開始インデックスを 1 にする。 | [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/ ループ処理] によって配列からポップアップメニューのアイテムを生成する場合に、[[マクロリファレンス:PopupMenu インターフェイス#Add メソッド|PopupMenu.Add() メソッド]] の第二引数 '''id''' (※通常は 1 ~ )と配列のアイテムのインデックス '''[ i ]''' の値(※通常は 0 ~ )を一致させたいときは、配列の先頭にダミーまたは空の要素を置いておき、ループ処理の開始インデックスを 1 にする。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var a = new Array( "" ); // 先頭に空のダミー要素を入れておく | var a = new Array( "" ); // 先頭に空のダミー要素を入れておく | ||
| 760行目: | 760行目: | ||
} | } | ||
var numB = menuB.Track( mePosMouse ); | var numB = menuB.Track( mePosMouse ); | ||
</ | </syntaxhighlight> | ||
| 768行目: | 768行目: | ||
サブメニューを多重に含むコードの場合、字下げ(インデント)を活用することで、メニューの階層構造を把握しやすくできる。 | サブメニューを多重に含むコードの場合、字下げ(インデント)を活用することで、メニューの階層構造を把握しやすくできる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var mainMenu = CreatePopupMenu(); | var mainMenu = CreatePopupMenu(); | ||
mainMenu.Add( "アイテム1", 1 ); | mainMenu.Add( "アイテム1", 1 ); | ||
| 778行目: | 778行目: | ||
var r = mainMenu.Track( 0 ); | var r = mainMenu.Track( 0 ); | ||
Alert( r > 0 ? mainMenu.GetText( r ) : "キャンセル" ); | Alert( r > 0 ? mainMenu.GetText( r ) : "キャンセル" ); | ||
</ | </syntaxhighlight> | ||
<br><br> | <br><br> | ||
* 配列やオブジェクトからポップアップメニューの生成をするときにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、<span style="color:#c00;">要素が不定数の配列やオブジェクトを複数のサブメニューに振り分けるのは簡単ではない…。</span> | * 配列やオブジェクトからポップアップメニューの生成をするときにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、<span style="color:#c00;">要素が不定数の配列やオブジェクトを複数のサブメニューに振り分けるのは簡単ではない…。</span> | ||
| 790行目: | 790行目: | ||
: サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように(またはグレーアウトされるように) <code>PopupMenu.AddPopup()</code> 周りを [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲うしかない(※ メニューの階層構造が複雑な場合に、ソースコードが見づらくなってしまうが…)。 | : サブメニュー内のすべてのアイテムが無効(グレーアウト)になる条件でも、サブメニュー見出しを無効化することはできないので、サブメニュー見出しが表示されなくなるように(またはグレーアウトされるように) <code>PopupMenu.AddPopup()</code> 周りを [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲うしかない(※ メニューの階層構造が複雑な場合に、ソースコードが見づらくなってしまうが…)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. 編集モードが Text ならサブメニューを表示する | // e.g. 編集モードが Text ならサブメニューを表示する | ||
// ※ Text 以外ならグレーアウトさせた "サブメニュー" アイテムを表示 | // ※ Text 以外ならグレーアウトさせた "サブメニュー" アイテムを表示 | ||
| 806行目: | 806行目: | ||
var r = menu1.Track( mePosMouse ); | var r = menu1.Track( mePosMouse ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
: また、上出の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。<br> → サブメニューオブジェクトを <code>AddPopup()</code> する前に孫アイテムを <code>Add()</code> しておき、チェックつきアイテムを含むかどうかの条件文でサブメニューオブジェクトのラベルを生成(サブメニューラベルの先頭に "'''*'''\t" や "'''✔'''" などを付加)してから <code>AddPopup()</code> することはできるが、 ''meMenuChecked'' とおなじチェックマークをつけられるわけではないので、コードが煩雑になるわりにあまり報われない努力となる…。 | : また、上出の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。<br> → サブメニューオブジェクトを <code>AddPopup()</code> する前に孫アイテムを <code>Add()</code> しておき、チェックつきアイテムを含むかどうかの条件文でサブメニューオブジェクトのラベルを生成(サブメニューラベルの先頭に "'''*'''\t" や "'''✔'''" などを付加)してから <code>AddPopup()</code> することはできるが、 ''meMenuChecked'' とおなじチェックマークをつけられるわけではないので、コードが煩雑になるわりにあまり報われない努力となる…。 | ||
| 836行目: | 836行目: | ||
=== 配列 === | === 配列 === | ||
< | <syntaxhighlight lang="javascript"> | ||
var arr1 = []; | var arr1 = []; | ||
arr1[arr1.length] = "hoge"; | arr1[arr1.length] = "hoge"; | ||
| 842行目: | 842行目: | ||
arr1[arr1.length] = "piyo"; | arr1[arr1.length] = "piyo"; | ||
... ; | ... ; | ||
</ | </syntaxhighlight> | ||
個人的な所感であるが、配列の要素を羅列して定義するさいに、上のような書き方は好きではない。以下のような書き方のほうが、スッキリしていてよい。 | 個人的な所感であるが、配列の要素を羅列して定義するさいに、上のような書き方は好きではない。以下のような書き方のほうが、スッキリしていてよい。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var arr2 = []; | var arr2 = []; | ||
arr2.push( "Hoge" ); | arr2.push( "Hoge" ); | ||
| 850行目: | 850行目: | ||
arr2.push( "Piyo" ); | arr2.push( "Piyo" ); | ||
... ; | ... ; | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
var arr3 = [ | var arr3 = [ | ||
"HogeHoge", | "HogeHoge", | ||
| 859行目: | 859行目: | ||
]; | ]; | ||
// ※ カンマの位置は、前でも後ろでも | // ※ カンマの位置は、前でも後ろでも | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 867行目: | 867行目: | ||
<br><br> | <br><br> | ||
※ 以下のふたつのコードは、左下(行頭位置)から右上に矩形選択した状態から実行したときの結果が異なる。 | ※ 以下のふたつのコードは、左下(行頭位置)から右上に矩形選択した状態から実行したときの結果が異なる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var s = document.selection; | var s = document.selection; | ||
// もとの選択範囲の座標を取得 | // もとの選択範囲の座標を取得 | ||
| 879行目: | 879行目: | ||
s.EndOfLine( false, mePosLogical ); | s.EndOfLine( false, mePosLogical ); | ||
s.SetAnchorPoint( mePosLogical, 1, ty ); | s.SetAnchorPoint( mePosLogical, 1, ty ); | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
// または masme 氏作成の「コメントマーク付け外し」マクロより | // または masme 氏作成の「コメントマーク付け外し」マクロより | ||
// ※ 左下(行頭位置)から右上に矩形選択した場合も考慮したコード | // ※ 左下(行頭位置)から右上に矩形選択した場合も考慮したコード | ||
| 892行目: | 892行目: | ||
s.EndOfLine( false, mePosLogical ); | s.EndOfLine( false, mePosLogical ); | ||
s.SetAnchorPoint( mePosLogical, 1, ty ); | s.SetAnchorPoint( mePosLogical, 1, ty ); | ||
</ | </syntaxhighlight> | ||
: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/4431 マクロについてアドバイスお願いします]』 | : ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/4431 マクロについてアドバイスお願いします]』 | ||
<br><br> | <br><br> | ||
| 900行目: | 900行目: | ||
<br> | <br> | ||
<span style="color:#c00;">※ '''GetTopPos()''' や '''GetBottomPos()''' というメソッドはない。 </span><br> | <span style="color:#c00;">※ '''GetTopPos()''' や '''GetBottomPos()''' というメソッドはない。 </span><br> | ||
< | <syntaxhighlight lang="javascript"> | ||
var ancPos, actPos, topPos, endPos; | var ancPos, actPos, topPos, endPos; | ||
| 912行目: | 912行目: | ||
topPos = ( ancPos < actPos ) ? ancPos : actPos; | topPos = ( ancPos < actPos ) ? ancPos : actPos; | ||
endPos = ( ancPos < actPos ) ? actPos : ancPos; | endPos = ( ancPos < actPos ) ? actPos : ancPos; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
=== 変換・挿入した文字列を範囲選択するとき === | === 変換・挿入した文字列を範囲選択するとき === | ||
< | <syntaxhighlight lang="javascript"> | ||
var str = "hoge"; | var str = "hoge"; | ||
document.Write( str ); // または document.selection.text = str; | document.Write( str ); // または document.selection.text = str; | ||
</ | </syntaxhighlight> | ||
のあとで文字列 '''hoge''' を範囲選択したい場合は、< | のあとで文字列 '''hoge''' を範囲選択したい場合は、<syntaxhighlight lang="javascript" inline>document.selection.CharLeft( str.length, true );</syntaxhighlight> ではなく | ||
< | <syntaxhighlight lang="javascript"> | ||
// キャレットは選択範囲の末尾位置 | // キャレットは選択範囲の末尾位置 | ||
document.selection.SetAnchorPos( document.selection.GetActivePos() - str.length ); | document.selection.SetAnchorPos( document.selection.GetActivePos() - str.length ); | ||
| 927行目: | 927行目: | ||
// または(キャレットは選択範囲の先頭位置) | // または(キャレットは選択範囲の先頭位置) | ||
document.selectionSetActivePos( document.selection.GetActivePos() - str.length, true ); | document.selectionSetActivePos( document.selection.GetActivePos() - str.length, true ); | ||
</ | </syntaxhighlight> | ||
と記述すること。 | と記述すること。 | ||
<br><br> | <br><br> | ||
| 975行目: | 975行目: | ||
<br><br> | <br><br> | ||
じっさいのマクロのコーディングでは行全体の文字列を | じっさいのマクロのコーディングでは行全体の文字列を | ||
< | <syntaxhighlight lang="javascript"> | ||
// 1行選択 | // 1行選択 | ||
document.selection.StartOfLine( mePosLogical ); | document.selection.StartOfLine( mePosLogical ); | ||
document.selection.EndOfLine( mePosLogical, true ); | document.selection.EndOfLine( mePosLogical, true ); | ||
</ | </syntaxhighlight> | ||
または [[#複数行の論理行を範囲選択(末尾改行を含まない)|複数行の論理行を範囲選択(末尾改行を含まない)]] のようなコードで範囲選択状態にしてから「行を複製」することが多いので、< | または [[#複数行の論理行を範囲選択(末尾改行を含まない)|複数行の論理行を範囲選択(末尾改行を含まない)]] のようなコードで範囲選択状態にしてから「行を複製」することが多いので、<syntaxhighlight lang="javascript" inline>document.selection.Text = document.selection.Text + "\n" + document.selection.Text;</syntaxhighlight> とすれば「複製」後のキャレット位置が曖昧になることはない。 | ||
: ''ref.'' 拙作「[[行を複製 (複数行可)]]」マクロ | : ''ref.'' 拙作「[[行を複製 (複数行可)]]」マクロ | ||
<br> | <br> | ||
| 986行目: | 986行目: | ||
[[マクロリファレンス:Selection インターフェイス#Indent メソッド|Selection.Indent() メソッド]] / [[マクロリファレンス:Selection インターフェイス#Unindent メソッド|Selection.Unindent() メソッド]] は | [[マクロリファレンス:Selection インターフェイス#Indent メソッド|Selection.Indent() メソッド]] / [[マクロリファレンス:Selection インターフェイス#Unindent メソッド|Selection.Unindent() メソッド]] は | ||
* 「選択範囲のテキスト」ではなく、「選択範囲をふくむ論理行全体」が操作対象。 | * 「選択範囲のテキスト」ではなく、「選択範囲をふくむ論理行全体」が操作対象。 | ||
* 選択範囲が表示行での1行全体に達していないと空振りするので、事前に行全体を範囲選択する(''e.g.'' < | * 選択範囲が表示行での1行全体に達していないと空振りするので、事前に行全体を範囲選択する(''e.g.'' <syntaxhighlight lang="javascript" inline>document.selection.SelectLine(); // または SelectLine( true );</syntaxhighlight> )や [[#複数行の論理行を範囲選択(末尾改行を含まない)|複数行の論理行を範囲選択(末尾改行を含まない)]] のようなコードが必要。 | ||
* 実行可能条件を満たしてから実行すると、「もとの選択範囲をふくむ論理行全体 (<span style="color:#0000c0;">末尾改行を'''ふくむ'''</span>)」が範囲選択された状態で残る。 | * 実行可能条件を満たしてから実行すると、「もとの選択範囲をふくむ論理行全体 (<span style="color:#0000c0;">末尾改行を'''ふくむ'''</span>)」が範囲選択された状態で残る。 | ||
* 引数に 1 以上の数値を渡して実行すると、「元に戻す」さいには <code>document.selection.Indent(n)</code> や <code>document.selection.Unindent(n)</code> での引数の値とおなじ回数の [[マクロリファレンス:Document インターフェイス#Undo メソッド|<code>document.Undo()</code>]] や Ctrl+Z の操作が必要。 | * 引数に 1 以上の数値を渡して実行すると、「元に戻す」さいには <code>document.selection.Indent(n)</code> や <code>document.selection.Unindent(n)</code> での引数の値とおなじ回数の [[マクロリファレンス:Document インターフェイス#Undo メソッド|<code>document.Undo()</code>]] や Ctrl+Z の操作が必要。 | ||
| 1,008行目: | 1,008行目: | ||
* 「論理行」全体の選択のみで、「表示行」の選択には非対応。 | * 「論理行」全体の選択のみで、「表示行」の選択には非対応。 | ||
: ※ エディタ内でのトリプルクリック操作に相当し、行末改行も選択範囲にふくまれる。 | : ※ エディタ内でのトリプルクリック操作に相当し、行末改行も選択範囲にふくまれる。 | ||
* 引数に < | * 引数に <syntaxhighlight lang="javascript" inline>true</syntaxhighlight> を渡すと複数行選択が可能。 | ||
* トリプルクリックや行番号のクリック(またはドラッグ)で論理行全体が範囲選択された状態から実行すると、もとの選択範囲末尾改行のつぎの行まで範囲選択されてしまう。 | * トリプルクリックや行番号のクリック(またはドラッグ)で論理行全体が範囲選択された状態から実行すると、もとの選択範囲末尾改行のつぎの行まで範囲選択されてしまう。 | ||
: ''c.f.'' [[#複数行の論理行を範囲選択(末尾改行を含まない)|複数行の論理行を範囲選択(末尾改行を含まない)]] | : ''c.f.'' [[#複数行の論理行を範囲選択(末尾改行を含まない)|複数行の論理行を範囲選択(末尾改行を含まない)]] | ||
| 1,048行目: | 1,048行目: | ||
<br> | <br> | ||
* <span style="color:#c00;">「検索/置換」ダイアログのオプションフラグをすべて OFF にする方法</span> として | * <span style="color:#c00;">「検索/置換」ダイアログのオプションフラグをすべて OFF にする方法</span> として | ||
: < | : <syntaxhighlight lang="javascript" inline>document.selection.Find( "", 0 ); // 空文字列の検索でオプションフラグを解除する</syntaxhighlight><br> | ||
: というコードを挟み込む手法がある(第二引数には 0 または 1 を指定する)。 | : というコードを挟み込む手法がある(第二引数には 0 または 1 を指定する)。 | ||
:: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/3398 空検索の動作、など]』 | :: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/3398 空検索の動作、など]』 | ||
| 1,060行目: | 1,060行目: | ||
* [https://www.haijin-boys.com/software/mery/mery-2-8-3#13 ベータ版 2.8.3] で追加された ''meFindMigemo'' と従来からの ''meFindReplaceRegExp'' も排他関係で、''meFindMigemo'' が優先される。 | * [https://www.haijin-boys.com/software/mery/mery-2-8-3#13 ベータ版 2.8.3] で追加された ''meFindMigemo'' と従来からの ''meFindReplaceRegExp'' も排他関係で、''meFindMigemo'' が優先される。 | ||
<br> | <br> | ||
* [https://www.haijin-boys.com/software/mery/mery-3-0-0#13 Mery ver 3.0.1] での定数 ''meFindKeepOptions'' の追加にともない、マクロで <code>Find()</code> メソッドを使用したあとに「検索/置換」ダイアログ内の「Migemo を使用する」オプションの状態もリセットされるようになった (''meFindMigemo'' の有無で Migemo の ON/OFF が切り替わる)ようなので、< | * [https://www.haijin-boys.com/software/mery/mery-3-0-0#13 Mery ver 3.0.1] での定数 ''meFindKeepOptions'' の追加にともない、マクロで <code>Find()</code> メソッドを使用したあとに「検索/置換」ダイアログ内の「Migemo を使用する」オプションの状態もリセットされるようになった (''meFindMigemo'' の有無で Migemo の ON/OFF が切り替わる)ようなので、<syntaxhighlight lang="javascript" inline>document.selection.Find( "", 0 );</syntaxhighlight> を使用すると「Migemo を使用する」オプションは OFF (無効) になる。 | ||
: ※「検索/置換」ダイアログの検索文字列欄に <q>HOGE</q> が入力されたまま閉じて、マクロで < | : ※「検索/置換」ダイアログの検索文字列欄に <q>HOGE</q> が入力されたまま閉じて、マクロで <syntaxhighlight lang="javascript" inline>document.selection..Find( "FUGA", meFindKeepOptions );</syntaxhighlight> を実行すると、検索ハイライトされた文字列と「検索/置換」ダイアログ内の検索文字列に齟齬が生じることになる<br> ( ⇒ 「次/前を検索(F3/Shift+F3)」コマンドでは <q>HOGE</q> が再検索される)。 | ||
: たとえば「[[検索(SJIS以外)]]」マクロのような長大な正規表現を使用するマクロで ''meFindKeepOptions'' を適用すると、マクロ実行後に [Shift+F3] キーによる上方向への再検索はできなくなるので、長大な検索文字列を検索履歴に残したくない特殊な検索(置換)マクロの場合での扱いはむずかしい (検索マクロに「[[GetKeyState.exe(キー状態取得実行ファイル)]]」を導入して、''meFindNext''/''meFindPrevious'' を切り替える、または ''meFindKeepOptions'' の有無を切り替えるなどの対応をするか、検索方向(次/前)の差分で検索マクロを2件登録するか…)。 | : たとえば「[[検索(SJIS以外)]]」マクロのような長大な正規表現を使用するマクロで ''meFindKeepOptions'' を適用すると、マクロ実行後に [Shift+F3] キーによる上方向への再検索はできなくなるので、長大な検索文字列を検索履歴に残したくない特殊な検索(置換)マクロの場合での扱いはむずかしい (検索マクロに「[[GetKeyState.exe(キー状態取得実行ファイル)]]」を導入して、''meFindNext''/''meFindPrevious'' を切り替える、または ''meFindKeepOptions'' の有無を切り替えるなどの対応をするか、検索方向(次/前)の差分で検索マクロを2件登録するか…)。 | ||
<br> | <br> | ||
| 1,079行目: | 1,079行目: | ||
* <code>FindRepeat()</code> メソッドで ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround'' を適用した検索をしたいばあいは、以下のように記述する。 | * <code>FindRepeat()</code> メソッドで ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround'' を適用した検索をしたいばあいは、以下のように記述する。 | ||
: ※ ''meFindReplaceRegExp'' があっても <code>FindRepeat()</code> の実行時には無視される。 | : ※ ''meFindReplaceRegExp'' があっても <code>FindRepeat()</code> の実行時には無視される。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// FindRepeat() で使用したいフラグ | // FindRepeat() で使用したいフラグ | ||
var flags = meFindReplaceCase + meFindAround; | var flags = meFindReplaceCase + meFindAround; | ||
| 1,093行目: | 1,093行目: | ||
// ➂ 最後にオプションフラグを解除しておきたいなら | // ➂ 最後にオプションフラグを解除しておきたいなら | ||
document.selection.Find( "", 0 ); | document.selection.Find( "", 0 ); | ||
</ | </syntaxhighlight> | ||
: ※ ➂ の行のコードを最後に使用した場合、「検索/置換」ダイアログのオプションフラグも解除される。 | : ※ ➂ の行のコードを最後に使用した場合、「検索/置換」ダイアログのオプションフラグも解除される。 | ||
<br> | <br> | ||
| 1,103行目: | 1,103行目: | ||
実行前になんらかの文字列を検索していて "検索マーカーが表示されている場合" を考慮すると、なかなか面倒な部分が多い…。 | 実行前になんらかの文字列を検索していて "検索マーカーが表示されている場合" を考慮すると、なかなか面倒な部分が多い…。 | ||
<br> | <br> | ||
< | <syntaxhighlight lang="javascript"> | ||
/** | /** | ||
* 「スペース×2削除」マクロの Mery v3 対応テスト | * 「スペース×2削除」マクロの Mery v3 対応テスト | ||
| 1,156行目: | 1,156行目: | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
* ちなみに、sukemaru は検索ダイアログの履歴に残るマクロや、検索ハイライトが残るマクロが好きではないので、なるべく <code>Selection.Find()</code> や <code>Selection.Replace()</code> を使わずに JavaScript ネイティブの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf String.indexOf( searchValue, fromIndex )] / [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/search String.search( regexp ) メソッド] や [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace String.replace( regexp ) メソッド] で検索/置換を行なったり、あるいは [[マクロリファレンス:Document インターフェイス#HighlightFind プロパティ|Document.HighlightFind = false]] で最終的に検索マーカーを消すなどする自作マクロが多い ([https://www.haijin-boys.com/software/mery/mery-2-6-0#3 自動マーカー] でハイライトさせる設定にしているから「検索ハイライト」はいらなくて…)。 | * ちなみに、sukemaru は検索ダイアログの履歴に残るマクロや、検索ハイライトが残るマクロが好きではないので、なるべく <code>Selection.Find()</code> や <code>Selection.Replace()</code> を使わずに JavaScript ネイティブの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf String.indexOf( searchValue, fromIndex )] / [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/search String.search( regexp ) メソッド] や [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/replace String.replace( regexp ) メソッド] で検索/置換を行なったり、あるいは [[マクロリファレンス:Document インターフェイス#HighlightFind プロパティ|Document.HighlightFind = false]] で最終的に検索マーカーを消すなどする自作マクロが多い ([https://www.haijin-boys.com/software/mery/mery-2-6-0#3 自動マーカー] でハイライトさせる設定にしているから「検索ハイライト」はいらなくて…)。 | ||
| 1,166行目: | 1,166行目: | ||
=== 文字列操作が空振りしたときは undo 履歴に残さない === | === 文字列操作が空振りしたときは undo 履歴に残さない === | ||
* 条件付きで文字列操作(挿入・置換など)するマクロが空振りしたとき | * 条件付きで文字列操作(挿入・置換など)するマクロが空振りしたとき | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. 選択範囲に「hoge」が含まれていれば「fuga」に置換する | // e.g. 選択範囲に「hoge」が含まれていれば「fuga」に置換する | ||
var fuga = document.selection.Text.replace( /hoge/g, "fuga" ); | var fuga = document.selection.Text.replace( /hoge/g, "fuga" ); | ||
document.selection.Text = fuga; | document.selection.Text = fuga; | ||
</ | </syntaxhighlight> | ||
: 上のようなコードの場合は '''undo''' 履歴に無駄に残ったり、文書に「'''未保存 *'''」のフラグが付加されたりする。 | : 上のようなコードの場合は '''undo''' 履歴に無駄に残ったり、文書に「'''未保存 *'''」のフラグが付加されたりする。 | ||
: 以下のように「文字列操作の前後で "変化なし" なら undo 履歴には残さない」記述にすると、[https://www.haijin-boys.com/software/mery/mery-2-6-9#4 変更行の強調表示] なども無用に付かなくなる。 | : 以下のように「文字列操作の前後で "変化なし" なら undo 履歴には残さない」記述にすると、[https://www.haijin-boys.com/software/mery/mery-2-6-9#4 変更行の強調表示] なども無用に付かなくなる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. 選択範囲に「hoge」が含まれなければ置換しない | // e.g. 選択範囲に「hoge」が含まれなければ置換しない | ||
var st = document.selection.Text; | var st = document.selection.Text; | ||
| 1,182行目: | 1,182行目: | ||
document.selection.Text = piyo; | document.selection.Text = piyo; | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 1,188行目: | 1,188行目: | ||
: [[マクロリファレンス:Selection インターフェイス|Document.Selection クラス]] の文字列操作メソッドの場合は、以下のように記述することで「<span style="color:#0000c0;">変換なしなら undo 履歴を巻き戻し</span>」できる。 | : [[マクロリファレンス:Selection インターフェイス|Document.Selection クラス]] の文字列操作メソッドの場合は、以下のように記述することで「<span style="color:#0000c0;">変換なしなら undo 履歴を巻き戻し</span>」できる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// 変換前の文字列 と 保存済み/未保存 の状態を取得 | // 変換前の文字列 と 保存済み/未保存 の状態を取得 | ||
var st = document.selection.Text; | var st = document.selection.Text; | ||
| 1,204行目: | 1,204行目: | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
: ※ ただし、厳密にいえば undo 履歴には残っているので、'''redo''' (やり直し: Ctrl+Y) することができる。 | : ※ ただし、厳密にいえば undo 履歴には残っているので、'''redo''' (やり直し: Ctrl+Y) することができる。 | ||
<br><br> | <br><br> | ||
| 1,218行目: | 1,218行目: | ||
<br> | <br> | ||
: 以下は、ジャンプしてスクロールが発生した場合に、キャレットが表示領域の先頭位置になるようにスクロール状態(<code>window.ScrollY</code>)を調整するコード。 | : 以下は、ジャンプしてスクロールが発生した場合に、キャレットが表示領域の先頭位置になるようにスクロール状態(<code>window.ScrollY</code>)を調整するコード。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var s = Document.Selection; | var s = Document.Selection; | ||
var ax = s.GetActivePointX( mePosLogical ); // キャレット位置の X | var ax = s.GetActivePointX( mePosLogical ); // キャレット位置の X | ||
| 1,236行目: | 1,236行目: | ||
// ※ ScrollY プロパティに値を代入するときは物理座標(表示行)の行番号で | // ※ ScrollY プロパティに値を代入するときは物理座標(表示行)の行番号で | ||
</ | </syntaxhighlight> | ||
※ スクロールマージンは [https://www.haijin-boys.com/software/mery/mery-2-7-0#2 ベータ版 2.7.0] より「オプション」ダイアログの「スクロール」のページ内で変更できるようになっている。[https://www.haijin-boys.com/weblog/assets/uploads/2019/04/mery-2-7-0-4.png?20190417] | ※ スクロールマージンは [https://www.haijin-boys.com/software/mery/mery-2-7-0#2 ベータ版 2.7.0] より「オプション」ダイアログの「スクロール」のページ内で変更できるようになっている。[https://www.haijin-boys.com/weblog/assets/uploads/2019/04/mery-2-7-0-4.png?20190417] | ||
| 1,248行目: | 1,248行目: | ||
=== Window オブジェクト === | === Window オブジェクト === | ||
通常はソースコード内で [[マクロリファレンス:Window インターフェイス|Window オブジェクト]] を明示的に記述する必要はないが、[[#動作要件としてのバージョンチェック|バージョンチェック]] の節の「例4」のように <span style="color:#c00;"> 実際に記述する場合には <code>Window</code> ではなく < | 通常はソースコード内で [[マクロリファレンス:Window インターフェイス|Window オブジェクト]] を明示的に記述する必要はないが、[[#動作要件としてのバージョンチェック|バージョンチェック]] の節の「例4」のように <span style="color:#c00;"> 実際に記述する場合には <code>Window</code> ではなく <syntaxhighlight lang="javascript" inline>window</syntaxhighlight> でないと宣言されていない変数・オブジェクトあつかいのエラーになる。</span> | ||
※ <code>Document</code> や <code>Selection</code>、<code>Alert</code> など他の主要なプロパティは「大文字/小文字/頭文字のみ大文字」の区別なしに同一のプロパティとしてあつかわれる。 | ※ <code>Document</code> や <code>Selection</code>、<code>Alert</code> など他の主要なプロパティは「大文字/小文字/頭文字のみ大文字」の区別なしに同一のプロパティとしてあつかわれる。 | ||
| 1,259行目: | 1,259行目: | ||
:※ マクロでカレントディレクトリを変更すると、実行中の Mery のプロセスの作業フォルダも変更されるため、あとから他のマクロを実行するさいのカレントディレクトリにも影響する。 | :※ マクロでカレントディレクトリを変更すると、実行中の Mery のプロセスの作業フォルダも変更されるため、あとから他のマクロを実行するさいのカレントディレクトリにも影響する。 | ||
<br> | <br> | ||
< | <syntaxhighlight lang="javascript"> | ||
// マクロ実行前の作業フォルダを保存する | // マクロ実行前の作業フォルダを保存する | ||
var wshShell = new ActiveXObject( "WScript.Shell" ); | var wshShell = new ActiveXObject( "WScript.Shell" ); | ||
| 1,271行目: | 1,271行目: | ||
// 最終的にマクロ実行前の作業フォルダを復帰する | // 最終的にマクロ実行前の作業フォルダを復帰する | ||
wshShell.CurrentDirectory = currentDir; | wshShell.CurrentDirectory = currentDir; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
* システムの関連付けを利用してテキストファイルなどのダブルクリックから Mery を起動した場合、そのファイルの親フォルダが Mery のプロセスの作業フォルダとなり、Windows OS の仕様により Mery のプロセスを終了するまでそのフォルダはロックされた状態になる(フォルダの移動や削除ができなくなる)が、マクロでカレントディレクトリを変更するとフォルダのロックを解除できる。 | * システムの関連付けを利用してテキストファイルなどのダブルクリックから Mery を起動した場合、そのファイルの親フォルダが Mery のプロセスの作業フォルダとなり、Windows OS の仕様により Mery のプロセスを終了するまでそのフォルダはロックされた状態になる(フォルダの移動や削除ができなくなる)が、マクロでカレントディレクトリを変更するとフォルダのロックを解除できる。 | ||
| 1,285行目: | 1,285行目: | ||
* 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] | ||
: ベータバージョンで追加された定数やプロパティが有効かどうかを調べる程度であれば、シンプルな記述で済む。 | : ベータバージョンで追加された定数やプロパティが有効かどうかを調べる程度であれば、シンプルな記述で済む。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// ▼ ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降 | // ▼ ChangeCase() メソッドで定数 meCaseCapitalize を使えるのは ver 2.6.10 以降 | ||
| 1,316行目: | 1,316行目: | ||
Status = "小文字…。"; | Status = "小文字…。"; | ||
} | } | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
// ▼ BeginUndoGroup() メソッドを使えるのは ver 2.7.0 以降 | // ▼ BeginUndoGroup() メソッドを使えるのは ver 2.7.0 以降 | ||
| 1,335行目: | 1,335行目: | ||
BeginUndoGroup(); | BeginUndoGroup(); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 1,342行目: | 1,342行目: | ||
<br><br> | <br><br> | ||
* [[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | * [[includeライブラリ|include ライブラリ]] が必要なマクロの場合、ユーザー側が include ライブラリを正しく導入していることが要求される。 | ||
: ユーザー側で include ライブラリを導入していて、マクロ側で < | : ユーザー側で include ライブラリを導入していて、マクロ側で <syntaxhighlight lang="javascript" inline>#include "include/IO.js"</syntaxhighlight> のようなプリプロセッサがソースコードの先頭で宣言されていれば問題ないのだが、include ライブラリが導入されていなくても、プリプロセッサを削除(コメントアウト)すればマクロがある程度動くようにコーディングすることもできる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// #include "include/IO.js" | // #include "include/IO.js" | ||
| 1,352行目: | 1,352行目: | ||
/* IO.js がインクルードされていないときの代替動作 */ ; | /* IO.js がインクルードされていないときの代替動作 */ ; | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
* また、[[GetKeyState.exe(キー状態取得実行ファイル)]] のあるなしで動作内容を分けるなら、以下のようにコードを記述すればよい。 | * また、[[GetKeyState.exe(キー状態取得実行ファイル)]] のあるなしで動作内容を分けるなら、以下のようにコードを記述すればよい。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// あらかじめ変数 ctrl に 0 を代入しておく | // あらかじめ変数 ctrl に 0 を代入しておく | ||
var ctrl = 0; | var ctrl = 0; | ||
| 1,376行目: | 1,376行目: | ||
/* GetKeyState.exe がない、または Ctrl キーが押されていないとき */ ; | /* GetKeyState.exe がない、または Ctrl キーが押されていないとき */ ; | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
[[#TOP|>> 目次へ]] | [[#TOP|>> 目次へ]] | ||
| 1,431行目: | 1,431行目: | ||
<br><br> | <br><br> | ||
以下、「[[折り返しトグル切り替え#3つの折り返しモードを順々にトグルする|折り返しトグル切り替え]]」マクロを例に <code>IO.Serialize()</code> / <code>Deserialize()</code> の利用方法の簡単な説明。 | 以下、「[[折り返しトグル切り替え#3つの折り返しモードを順々にトグルする|折り返しトグル切り替え]]」マクロを例に <code>IO.Serialize()</code> / <code>Deserialize()</code> の利用方法の簡単な説明。 | ||
< | <syntaxhighlight lang="javascript"> | ||
#include "include/IO.js" | #include "include/IO.js" | ||
// \Macros\include\IO.js をインクルードする | // \Macros\include\IO.js をインクルードする | ||
| 1,490行目: | 1,490行目: | ||
// setting オブジェクトの変更内容を保存する | // setting オブジェクトの変更内容を保存する | ||
IO.Serialize( setting, jsonName ); | IO.Serialize( setting, jsonName ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
| 1,509行目: | 1,509行目: | ||
'''e.g. [[#メタ記号をエスケープする|半角英数字以外を「¥」でエスケープ処理する]]''' <br> | '''e.g. [[#メタ記号をエスケープする|半角英数字以外を「¥」でエスケープ処理する]]''' <br> | ||
※ あえて '''ループ処理で1行ずつエスケープ''' してみる ([[#その他、拙作マクロについて|@ロースペの XP ノート]]) | ※ あえて '''ループ処理で1行ずつエスケープ''' してみる ([[#その他、拙作マクロについて|@ロースペの XP ノート]]) | ||
< | <syntaxhighlight lang="javascript"> | ||
/* 関数バージョン */ | /* 関数バージョン */ | ||
| 1,528行目: | 1,528行目: | ||
} | } | ||
document.Text = a.join( "\n" ); | document.Text = a.join( "\n" ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
< | <syntaxhighlight lang="javascript" inline>function Quote( str )</syntaxhighlight> でも <syntaxhighlight lang="javascript" inline>var Quote = function( str )</syntaxhighlight> でも、約 9500 行の日本語テキスト(約 33 万文字)にたいして 1.1 秒台の処理時間がかかり有意な差はみられなかった。 | ||
<br> | <br> | ||
関数を使用しない以下のようなベタ書きのコードの場合でも、ほぼ同じ程度の処理時間がかかった (@ロースペの XP ノート)。 | 関数を使用しない以下のようなベタ書きのコードの場合でも、ほぼ同じ程度の処理時間がかかった (@ロースペの XP ノート)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
/* 非関数バージョン */ | /* 非関数バージョン */ | ||
| 1,543行目: | 1,543行目: | ||
} | } | ||
document.Text = a.join( "\n" ); | document.Text = a.join( "\n" ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
※ ループ文の中で関数を定義した場合は、やや遅くなって 1.3 秒台。 | ※ ループ文の中で関数を定義した場合は、やや遅くなって 1.3 秒台。 | ||
< | <syntaxhighlight lang="javascript"> | ||
BeginUndoGroup(); | BeginUndoGroup(); | ||
var lines = document.GetLines( 0 ); | var lines = document.GetLines( 0 ); | ||
| 1,557行目: | 1,557行目: | ||
} | } | ||
document.Text = a.join( "\n" ); | document.Text = a.join( "\n" ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
※ 行ごとのループ処理ではなく、文書全体の '''一括処理''' にすると速くなる。<br> | ※ 行ごとのループ処理ではなく、文書全体の '''一括処理''' にすると速くなる。<br> | ||
上とおなじ <code>Quote()</code> 関数を使用しての文書全体の一括処理でも… | 上とおなじ <code>Quote()</code> 関数を使用しての文書全体の一括処理でも… | ||
< | <syntaxhighlight lang="javascript"> | ||
function Quote( str ) { | function Quote( str ) { | ||
return str.replace( /\W/g, "\\$&" ); | return str.replace( /\W/g, "\\$&" ); | ||
| 1,568行目: | 1,568行目: | ||
document.Text = Quote( document.Text ); | document.Text = Quote( document.Text ); | ||
</ | </syntaxhighlight> | ||
関数を使用しないベタ書きの一括処理でも… | 関数を使用しないベタ書きの一括処理でも… | ||
< | <syntaxhighlight lang="javascript"> | ||
document.Text = document.Text.replace( /\W/g, "\\$&" ); | document.Text = document.Text.replace( /\W/g, "\\$&" ); | ||
</ | </syntaxhighlight> | ||
…処理時間はほぼ同じで、約 0.7 ~ 0.8 秒だった。 | …処理時間はほぼ同じで、約 0.7 ~ 0.8 秒だった。 | ||
<br> | <br> | ||
| 1,587行目: | 1,587行目: | ||
<br><br> | <br><br> | ||
※ ちなみに、<code>Quote()</code> 関数を以下のように記述した場合、上のようなループ処理コードでの所要時間は 3 倍(3 秒台)。 | ※ ちなみに、<code>Quote()</code> 関数を以下のように記述した場合、上のようなループ処理コードでの所要時間は 3 倍(3 秒台)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
function Quote( str ) { | function Quote( str ) { | ||
return str.replace( /\W/g, function( $0 ) { | return str.replace( /\W/g, function( $0 ) { | ||
| 1,593行目: | 1,593行目: | ||
} ); | } ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
以下のような記述だと、ループ処理した場合の所要時間は 4 倍以上(4 ~ 5 秒台)になる。 | 以下のような記述だと、ループ処理した場合の所要時間は 4 倍以上(4 ~ 5 秒台)になる。 | ||
< | <syntaxhighlight lang="javascript"> | ||
function Quote( str ) { | function Quote( str ) { | ||
return str.replace( /\W/g, Escape ); | return str.replace( /\W/g, Escape ); | ||
| 1,602行目: | 1,602行目: | ||
return "\\" + matched; | return "\\" + matched; | ||
} | } | ||
</ | </syntaxhighlight> | ||
…ループ処理から参照する関数のネストや二重参照は、ループ文内で関数を定義する場合以上に鬼門のようだ。 | …ループ処理から参照する関数のネストや二重参照は、ループ文内で関数を定義する場合以上に鬼門のようだ。 | ||
<br> | <br> | ||
| 1,613行目: | 1,613行目: | ||
* [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364436%28v%3dmsdn.10%29 WScript.Shell] などの WSH コードではパスをダブルクオートなどの <b style="color:#c00;">引用符で囲う必要がある</b> | * [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364436%28v%3dmsdn.10%29 WScript.Shell] などの WSH コードではパスをダブルクオートなどの <b style="color:#c00;">引用符で囲う必要がある</b> | ||
<br> | <br> | ||
よって、[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364421%28v%3dmsdn.10%29 WshShell.Run() コマンド] などで不特定のパス(または任意のパス)を指定するときは < | よって、[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364421%28v%3dmsdn.10%29 WshShell.Run() コマンド] などで不特定のパス(または任意のパス)を指定するときは <syntaxhighlight lang="javascript" inline>WshShell.Run( "\"" + path + "\"" )</syntaxhighlight> または <syntaxhighlight lang="javascript" inline>WshShell.Run( '"' + path + '"' )</syntaxhighlight> のように記述しておき、パスに半角空白がふくまれていてもエラーにならないように備えておくとよい。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// 半角空白を含むパス | // 半角空白を含むパス | ||
var path = "C:\\Hoge hoge\\Fuga fuga\\Piyo piyo.txt"; | var path = "C:\\Hoge hoge\\Fuga fuga\\Piyo piyo.txt"; | ||
| 1,625行目: | 1,625行目: | ||
wshShell.Run( "\"" + path + "\"" ); // 引用符で囲う必要がある | wshShell.Run( "\"" + path + "\"" ); // 引用符で囲う必要がある | ||
} | } | ||
</ | </syntaxhighlight> | ||
=== 警告・確認ダイアログとステータスバーの使い分け === | === 警告・確認ダイアログとステータスバーの使い分け === | ||
マクロからユーザーにメッセージを与える手段として '''警告'''([[マクロリファレンス:Window インターフェイス#Alert メソッド|window.Alert]])・'''確認'''([[マクロリファレンス:Window インターフェイス#Confirm メソッド|window.Confirm]])ダイアログと '''ステータスバー'''([[マクロリファレンス:Window インターフェイス#Status プロパティ|window.Status]])への表示などがある(ほかに '''アウトプットバー'''([[マクロリファレンス:OutputBar インターフェイス#Write メソッド|OutputBar.Write]])や '''ポップアップメニュー''' を使う方法もある)。 | マクロからユーザーにメッセージを与える手段として '''警告'''([[マクロリファレンス:Window インターフェイス#Alert メソッド|window.Alert]])・'''確認'''([[マクロリファレンス:Window インターフェイス#Confirm メソッド|window.Confirm]])ダイアログと '''ステータスバー'''([[マクロリファレンス:Window インターフェイス#Status プロパティ|window.Status]])への表示などがある(ほかに '''アウトプットバー'''([[マクロリファレンス:OutputBar インターフェイス#Write メソッド|OutputBar.Write]])や '''ポップアップメニュー''' を使う方法もある)。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. ポップアップメニューを「ポップアップヒント」として使用する | // e.g. ポップアップメニューを「ポップアップヒント」として使用する | ||
| 1,638行目: | 1,638行目: | ||
var r = m.Track( 1 ); | var r = m.Track( 1 ); | ||
} | } | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
基本的に、Mery のマクロで利用できるポップアップダイアログ(警告、確認)はどちらもシステムサウンドをともない、ボタン操作で閉じるまで作業を中断させてしまうので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | 基本的に、Mery のマクロで利用できるポップアップダイアログ(警告、確認)はどちらもシステムサウンドをともない、ボタン操作で閉じるまで作業を中断させてしまうので、あえて作業を一時停止させる必要がある場面以外ではステータス表示を使用するのがよい。 | ||
| 1,656行目: | 1,656行目: | ||
エラーダイアログは自家用の自作マクロのメンテナンスのさいには有用であるが、公開用のマクロの場合はユーザーがソースコードに誤った改変を加えてしまう惧れもあるので基本的に必要性がないとおもわれる。 | エラーダイアログは自家用の自作マクロのメンテナンスのさいには有用であるが、公開用のマクロの場合はユーザーがソースコードに誤った改変を加えてしまう惧れもあるので基本的に必要性がないとおもわれる。 | ||
<br><br> | <br><br> | ||
※ < | ※ <syntaxhighlight lang="javascript" inline>wshShell.Run( "実在しない実行ファイル.exe /間違ったパラメータ" );</syntaxhighlight> のようなコードの場合でも、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 文] を組み込むとよい。 | ||
< | <syntaxhighlight lang="javascript"> | ||
// e.g. コピーや上書き保存のようなファイルシステムを操作するマクロは | // e.g. コピーや上書き保存のようなファイルシステムを操作するマクロは | ||
// アクセス権限や読取専用ファイルへの書き込み、パスの指定ミスなど | // アクセス権限や読取専用ファイルへの書き込み、パスの指定ミスなど | ||
| 1,721行目: | 1,721行目: | ||
* try ... catch 文のあとのコードも処理される | * try ... catch 文のあとのコードも処理される | ||
*/ ; | */ ; | ||
</ | </syntaxhighlight> | ||
< | <syntaxhighlight lang="javascript"> | ||
// テスト | // テスト | ||
try{ | try{ | ||
| 1,731行目: | 1,731行目: | ||
} | } | ||
Status = "Error Test"; | Status = "Error Test"; | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
--> | --> | ||
| 1,748行目: | 1,748行目: | ||
: ※ ZIP 版の Mery でマクロを作成・運用しているので、インストーラ版では正しく動作しないマクロがあるかもしれません。 | : ※ ZIP 版の Mery でマクロを作成・運用しているので、インストーラ版では正しく動作しないマクロがあるかもしれません。 | ||
* 開発環境が Windows XP なので、拙作マクロは基本的に JavaScript(JScript)マクロです。 | * 開発環境が Windows XP なので、拙作マクロは基本的に JavaScript(JScript)マクロです。 | ||
: ※ 変数はすべて < | : ※ 変数はすべて <syntaxhighlight lang="javascript" inline>var</syntaxhighlight> で宣言し、JScript 5.8 の環境で実行できるようにコーディングしています。 | ||
* Mery のオプション設定で「行の表示方法=論理座標 (論理行)」の状態で運用する前提でマクロを作っています。 公開しているマクロでは、「表示座標 (表示行)」ベースで Mery を運用している場合でも利用できるように設定項目(変数)を設けるか「行の表示方法」を自動判定するコードを追加していますが、動作が不完全になったり処理がおそくなったりすることがあります。 | * Mery のオプション設定で「行の表示方法=論理座標 (論理行)」の状態で運用する前提でマクロを作っています。 公開しているマクロでは、「表示座標 (表示行)」ベースで Mery を運用している場合でも利用できるように設定項目(変数)を設けるか「行の表示方法」を自動判定するコードを追加していますが、動作が不完全になったり処理がおそくなったりすることがあります。 | ||
: <span style="color:#c00;"> ※「表示座標 (表示行)」ベースでの動作テストはほとんどしていません。</span> | : <span style="color:#c00;"> ※「表示座標 (表示行)」ベースでの動作テストはほとんどしていません。</span> | ||
| 1,764行目: | 1,764行目: | ||
→ 念のため確認してみたら、やはり差は僅かだった。 | → 念のため確認してみたら、やはり差は僅かだった。 | ||
: ※「include ライブラリ」の MeryInfo.js と [[マクロ覚え書き(開発者向け)#include ライブラリの IO クラスを利用する|IO.js をインクルード]] したマクロで Mery.ini ( 31 万文字超/約 5600 行、約 320 kB ) から「行の表示方法 (LineColumnView キー)」を取得すると、平均 0.125 秒。 | : ※「include ライブラリ」の MeryInfo.js と [[マクロ覚え書き(開発者向け)#include ライブラリの IO クラスを利用する|IO.js をインクルード]] したマクロで Mery.ini ( 31 万文字超/約 5600 行、約 320 kB ) から「行の表示方法 (LineColumnView キー)」を取得すると、平均 0.125 秒。 | ||
< | <syntaxhighlight lang="javascript"> | ||
#include "include/IO.js" | #include "include/IO.js" | ||
#include "include/MeryInfo.js" | #include "include/MeryInfo.js" | ||
| 1,776行目: | 1,776行目: | ||
Alert( "行の表示方法: " + ( lineColumnView ? "表示行" : "論理行" ) | Alert( "行の表示方法: " + ( lineColumnView ? "表示行" : "論理行" ) | ||
+ "\n\n" + ( ( new Date() - start ) / 1000 ).toFixed( 3 ) + " 秒" ); | + "\n\n" + ( ( new Date() - start ) / 1000 ).toFixed( 3 ) + " 秒" ); | ||
</ | </syntaxhighlight> | ||
<br> | <br> | ||
: ※ [[Mery.iniのオプション値を取得#GetIniOption2() 関数|組み込み関数 GetIniOption2()]] を利用したマクロで「行の表示方法」を取得すると、平均 0.095 秒。 | : ※ [[Mery.iniのオプション値を取得#GetIniOption2() 関数|組み込み関数 GetIniOption2()]] を利用したマクロで「行の表示方法」を取得すると、平均 0.095 秒。 | ||
< | <syntaxhighlight lang="javascript"> | ||
var start = new Date(); | var start = new Date(); | ||
// 関数の戻り値 iniOption[0][2] が LineColumnView キーの値 | // 関数の戻り値 iniOption[0][2] が LineColumnView キーの値 | ||
| 1,793行目: | 1,793行目: | ||
} | } | ||
// ---------- ▲ 組み込み関数 ココまで ▲ ---------- | // ---------- ▲ 組み込み関数 ココまで ▲ ---------- | ||
</ | </syntaxhighlight> | ||
: GetIniOption2() 関数は、<code>IO.LoadFromFile()</code> と <code>MeryInfo.GetIniPath()</code> のコードを翻案して作ったものなので、Mery.ini のパスを解決して [[マクロ覚え書き(開発者向け)#ADODB.Stream を利用する|ADODB.Stream で読みこむ]] 処理の部分はほぼ同じ。 Mery.ini のテキストデータから LineColumnView キーの値を検索する方法は異なるが、その部分は「include ライブラリ」を使用したコードの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/exec RegExp.exec( str ) メソッド] のほうが速いはず。<br> ※ GetIniOption2() 関数は [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/search String.search( regexp ) メソッド] と、[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf String.indexOf( searchValue, fromIndex ) メソッド] ×3回でキーの値を取得する。<br> | : GetIniOption2() 関数は、<code>IO.LoadFromFile()</code> と <code>MeryInfo.GetIniPath()</code> のコードを翻案して作ったものなので、Mery.ini のパスを解決して [[マクロ覚え書き(開発者向け)#ADODB.Stream を利用する|ADODB.Stream で読みこむ]] 処理の部分はほぼ同じ。 Mery.ini のテキストデータから LineColumnView キーの値を検索する方法は異なるが、その部分は「include ライブラリ」を使用したコードの [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/exec RegExp.exec( str ) メソッド] のほうが速いはず。<br> ※ GetIniOption2() 関数は [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/search String.search( regexp ) メソッド] と、[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf String.indexOf( searchValue, fromIndex ) メソッド] ×3回でキーの値を取得する。<br> | ||
: … とはいえど、「include ライブラリ」は多種多様な各クラス同士でのプロパティ(関数)の相互参照により高度に効率化されていて、おいそれとアレンジできない部分がたくさんあるため、素直にインクルードして利用するほうがよいのかも。 | : … とはいえど、「include ライブラリ」は多種多様な各クラス同士でのプロパティ(関数)の相互参照により高度に効率化されていて、おいそれとアレンジできない部分がたくさんあるため、素直にインクルードして利用するほうがよいのかも。 | ||
スポンサーリンク