Sukemaru (トーク | 投稿記録)
編集の要約なし
Sukemaru (トーク | 投稿記録)
編集の要約なし
113行目: 113行目:
* [https://pastebin.com/5rUw36qM StrConvテキスト変換メニュー] (uploaded: 2018/08/25) <br> 山本隆 氏作成の [http://gesource.jp/soft/strconv/strconvdll.html 文字変換ライブラリ StrConvDLL] の機能をポップアップメニューにまとめたマクロ
* [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 用マクロ「[[検索ヒット数表示(選択文字列)#機能強化バージョン|文字数・行数・ヒット件数(選択文字列)]]」を [https://mfactory.me/ gPad] 用に改編したもの
* [https://pastebin.com/Bci0eEx2 gPad用 文字数・行数・ヒット数] (uploaded: 2019/08/26) <br> Mery 用マクロ「[[検索ヒット数表示(選択文字列)#機能強化バージョン|文字数・行数・ヒット件数(選択文字列)]]」を [https://mfactory.me/ gPad] 用に改編したもの
 
<br><br>
 
[[#TOP|>> 目次へ]]
[[#TOP|>> 目次へ]]
 
<br><br>


= マクロ覚え書き =
= マクロ覚え書き =


== リンク ==
== リンク ==
<br>
; [[メインページ|MeryWiki]] / [https://www.haijin-boys.com/ Haijin Boys Online] 内
* [[マクロライブラリ#その他|マクロライブラリ]] にある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
* [[マクロライブラリ#その他|マクロライブラリ]] にある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」<br>
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」<br>
* MeryWiki の [[マクロリファレンス]]
* MeryWiki の [[マクロリファレンス]]
* MeryWiki の [[よくある質問|FAQ]]
* MeryWiki の [[よくある質問|FAQ (よくある質問)]]
* [https://www.haijin-boys.com/discussions Mery 公式フォーラム] <br>
* [https://www.haijin-boys.com/discussions Mery 公式フォーラム]  
* MDN web docus(mozzila)の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference JavaScript リファレンス] <br>
<br>
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392483(v=msdn.10) Microsoft Windows スクリプト テクノロジ]
; 外部サイト
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409859%28v%3dmsdn.10%29 JScript ランゲージ リファレンス]
* MDN web docus(mozzila)の「[https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference JavaScript リファレンス]」<br>
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364460(v=msdn.10) WSH リファレンス]
* MSDN(Microsoft Docs)の「[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc392483%28v=msdn.10%29 Microsoft Windows スクリプト テクノロジ]」
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc427968%28v%3dmsdn.10%29 FileSystemObject リファレンス]
* MSDN(Microsoft Docs)の「[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409859%28v%3dmsdn.10%29 JScript ランゲージ リファレンス]」
* MSDN(Microsoft Docs)の「[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc364460%28v=msdn.10%29 WSH リファレンス]」
* MSDN(Microsoft Docs)の「[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc427968%28v%3dmsdn.10%29 FileSystemObject リファレンス]」<br>
* MDN web docus(mozzila)の「[https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Regular_Expressions JavaScript ガイド >> 正規表現]」
* MSDN(Microsoft Docs)の「[https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc427946%28v=msdn.10%29 JScript 正規表現の概説]」
* onigmo(鬼雲 / 鬼車・改)の「[https://github.com/k-takata/Onigmo/blob/master/doc/RE.ja 正規表現 ReadMe]」
<br><br>
<br><br>
----
----
拙作マクロはポップアップメニューを利用するものが多いので、Tips はその方面の内容に偏ってしまいますが、以下、個人的に注意していることや気付いたことなど…。
拙作マクロはポップアップメニューを利用するものが多いので、Tips はその方面の内容に偏ってしまいますが、以下、個人的に注意していることや気付いたことなど。




165行目: 171行目:
</source>
</source>


: ※ オプションフラグ ''meMenuGrayed'' を使用して条件付きで特定の項目をグレーアウトするだけでなく、''menu.Add( ... );'' の行を [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲むなどすれば、状況に応じたメニュー項目だけを表示させることもできる。
<br><br>


=== アクセラレータ ===
=== アクセラレータ ===
221行目: 229行目:


=== ラベルの整形 ===
=== ラベルの整形 ===
基本的にポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている)。<br>
* 基本的にポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている)。<br>
文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。
: 文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。
<source lang="javascript">
<source lang="javascript">
/**
/**
276行目: 284行目:


: ※ Mery のダイアログのフォントは Mery.ini の「[[よくある質問#ダイアログのフォントを変更したい|隠しオプション]]」により任意のフォントに変更可なので、個人的にしか使わない非公開マクロであれば、ラベルの整形についてはあまり気にする必要はないかも。
: ※ Mery のダイアログのフォントは Mery.ini の「[[よくある質問#ダイアログのフォントを変更したい|隠しオプション]]」により任意のフォントに変更可なので、個人的にしか使わない非公開マクロであれば、ラベルの整形についてはあまり気にする必要はないかも。
 
<br>
* また、「[[#マクロライブラリに投稿したマクロ|マクロライブラリに投稿したマクロ]]」の節の画像リンク(サムネイル)のように、タブインデントや連番のケタ埋め、サブメニューの活用などの工夫で、ポップアップメニューの体裁はある程度自分好みにカスタマイズできる。
<br><br>


=== 配列からポップアップメニューを生成 ===
=== 配列からポップアップメニューを生成 ===
[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 にする。
[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 にする。
<source lang="javascript">
<source lang="javascript">
var a = new Array( "" ); // 先頭に空のダミー要素を入れておく
var a = new Array( "" ); // 先頭に空のダミー要素を入れておく
304行目: 314行目:
=== サブメニュー ===
=== サブメニュー ===
* 配列やオブジェクトからポップアップメニューを生成するさいにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、要素が不定数の配列やオブジェクトをサブメニューに振り分けるのは簡単ではない。
* 配列やオブジェクトからポップアップメニューを生成するさいにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、要素が不定数の配列やオブジェクトをサブメニューに振り分けるのは簡単ではない。
<br>
 
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、'''組み込み関数'''「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
<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()'' 周りを [https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Control_flow_and_error_handling#if...else_statement if() 文] で囲うしかない。
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。
: 上の「自動分割サブメニュー」の組み込み関数を制作するさい、チェックつきアイテムを含むサブメニュー見出しにもチェックを付けられるようにしたかったが、これも無理だった。


324行目: 334行目:
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。
 
<br><br>
 
[[#TOP|>> 目次へ]]
[[#TOP|>> 目次へ]]
 
<br><br>


== 選択範囲の 先頭位置/末尾位置 ==
== 選択範囲の 先頭位置/末尾位置 ==
347行目: 356行目:
</source>
</source>


== 変換・挿入した文字列を範囲選択するとき ==
<source lang="javascript">
var str = "hoge";
document.Write( str ); // または document.selection.text = str;
</source>
のあとで文字列 ''str'' ('''hoge''')を範囲選択したい場合は、''[[マクロリファレンス:Selection インターフェイス#CharLeft メソッド|document.selection.CharLeft]]( str.length, true );'' ではなく
<source lang="javascript">
document.selection.SetActivePos( document.selection.GetActivePos() - str.length, true );
// または
// document.selection.SetAnchorPos( document.selection.GetActivePos() - str.length );
</source>
と記述すること。
<br><br>
: <span style="color:#c00;"> ※ CharLeft( str.length, true ) の場合、文字列 ''str'' が「折り返し」にかかってしまったときに想定どおりの選択範囲にならない。</span>
: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/3740 "折り返し表示" での CharRight( document.selection.Text.length - 1 ) について]』
== 複数行の論理行を範囲選択(末尾改行を含まない) ==
: ※ 文字列操作のマクロでしばしば必要になる処理。
: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/4431 マクロについてアドバイスお願いします]』
<br><br>
[[#TOP|>> 目次へ]]
<br><br>


== Collapse() メソッド とキャレット位置 ==
== Collapse() メソッド とキャレット位置 ==
414行目: 447行目:
</source>
</source>
: ※ ➂ のコードを最後に使用した場合、「検索/置換」ダイアログのオプションフラグも解除される。
: ※ ➂ のコードを最後に使用した場合、「検索/置換」ダイアログのオプションフラグも解除される。
== 変換・挿入した文字列を範囲選択するとき ==
<source lang="javascript">
var str = "hoge";
document.Write( str ); // または document.selection.text = str;
</source>
のあとで文字列 ''str'' ('''hoge''')を範囲選択したい場合は、''[[マクロリファレンス:Selection インターフェイス#CharLeft メソッド|document.selection.CharLeft]]( str.length, true );'' ではなく
<source lang="javascript">
document.selection.SetActivePos( document.selection.GetActivePos() - str.length, true );
// または
// document.selection.SetAnchorPos( document.selection.GetActivePos() - str.length );
</source>
と記述すること。
<br><br>
: <span style="color:#c00;"> ※ CharLeft( str.length, true ) の場合、文字列 ''str'' が「折り返し」にかかってしまったときに想定どおりの選択範囲にならない。</span>
: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/3740 "折り返し表示" での CharRight( document.selection.Text.length - 1 ) について]』
== 複数行の論理行を範囲選択(末尾改行を含まない) ==
: ※ 文字列操作のマクロでしばしば必要になる処理。
: ref. Mery 公式フォーラム 『[https://www.haijin-boys.com/discussions/4431 マクロについてアドバイスお願いします]』




462行目: 473行目:
キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動先の行(表示座標での行番号)がエディタの表示領域の高さに収まるかどうかとジャンプ方向によるので安定的ではない(スクロールマージンの考慮も必要)。
キャレットをジャンプさせた後のスクロール位置とキャレット位置は、移動先の行(表示座標での行番号)がエディタの表示領域の高さに収まるかどうかとジャンプ方向によるので安定的ではない(スクロールマージンの考慮も必要)。
<br>
<br>
以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の [[マクロリファレンス:Window インターフェイス#ScrollY プロパティ|先頭位置(window.ScrollY)]] になるように調整するもの。
以下のコードは、ジャンプ後にエディタの表示領域がスクロールした場合に、キャレットが表示領域の 先頭位置([[マクロリファレンス:Window インターフェイス#ScrollY プロパティ|window.ScrollY]]) になるように調整するもの。
<source lang="javascript">
<source lang="javascript">
var s = Document.Selection;
var s = Document.Selection;
484行目: 495行目:


: ※ スクロールマージンは [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]
 
<br><br>
 
[[#TOP|>> 目次へ]]
[[#TOP|>> 目次へ]]
 
<br><br>


== カレントディレクトリ ==
== カレントディレクトリ ==
642行目: 652行目:
※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。
※ この場合、外部ファイルに設定内容をあずける項目の切り替えについては必ずマクロ経由で行なわなければならず、デフォルトの メニュー項目/ツールバーアイコン/ショートカットキー による通常操作でその項目の状態の変更をすると、最新の設定状態(現在の表示状態)と外部ファイルが保持している設定内容とのあいだに齟齬が生じてしまう。
: → e.g. 「[[折り返しトグル切り替え#3つの折り返しモードを順々にトグルする|折り返しトグル切り替え]]」マクロ
: → e.g. 「[[折り返しトグル切り替え#3つの折り返しモードを順々にトグルする|折り返しトグル切り替え]]」マクロ
<br><br>
[[#TOP|>> 目次へ]]
<br><br>
== 関数の「呼び出しコスト」 ==
ユーザー関数は呼び出し元から参照可能な位置に記述するならば、ソースコードの任意の位置に配置することができる。 繰り返し何度も呼び出して使用する関数の場合、「呼び出しコスト」を気にする人もいるらしいが、Mery で使用するマクロ程度のソースコードであればあまり気にする必要はないようにおもわれる。
<br>
; e.g. 半角英数字以外を「¥」でエスケープ処理する
: ※ あえてループ処理で1行ずつエスケープする
<source lang="javascript">
/* 関数バージョン */
function Quote( str ) {
  return str.replace( /\W/g, "\\$&" );
}
// または
// var Quote = function( str ) {
//  return str.replace( /\W/g, "\\$&" );
// }
BeginUndoGroup();
var lines = document.GetLines( 0 );
for ( var i = 1, st, a = []; i <= lines; i ++ ) {
  st = Quote( document.GetLine( i, 0 ) );
  a.push( st );
}
document.Text = a.join( "\n" );
</source>
<br>
function Quote( str ) でも var Quote = function( str ) でも、約 9500 行の日本語テキスト(約 30 万文字)にたいして 1.1 秒台の処理時間がかかり有意な差はみられなかったが、以下の関数を使用しないコードの場合でもほぼ同じ程度の処理時間がかかった (@ロースペの XP マシン)。
<source lang="javascript">
/* 非関数バージョン */
BeginUndoGroup();
var lines = document.GetLines( 0 );
for ( var i = 1, st, a = []; i <= lines; i ++ ) {
  st = document.GetLine( i, 0 ).replace( /\W/g, "\\$&" );
  a.push( st );
}
document.Text = a.join( "\n" );
</source>
<br>
※ なお、上とおなじ関数を使用しての文書全体の一括処理
<source lang="javascript">
document.Text = Quote( document.Text );
</source>
でも、関数を使用しない一括処理
<source lang="javascript">
document.Text = document.Text.replace( /\W/g, "\\$&" );
</source>
でも、処理時間はほぼ同じで 1 秒未満(約 0.7 ~ 0.8 秒)だった。
<br>
Chakra エンジン (jscript9.dll) の現行 OS を積んだ PC であれば約 20 倍の速度が出るらしいので、よほど長大な文書の処理でもなければ「関数の呼び出しコスト」を気にする必要はないとおもわれる。<br>
それよりも、文字列操作にさいしてキャレットの移動をともなうメソッドを使用しないとか、繰り返し参照されるオブジェクトやプロパティを変数に格納するとかで、ソースコードの最適化をはかるほうが良いはず。
<br><br>
<br><br>


772行目: 838行目:
Status = "Error Test";
Status = "Error Test";
</source>
</source>
 
<br><br>
 
[[#TOP|>> 目次へ]]
[[#TOP|>> 目次へ]]
 
<br><br>


== その他、拙作マクロについて ==
== その他、拙作マクロについて ==
* 拙作マクロは、基本的に JavaScript(JScript)マクロです。
* sukemaru の Mery 運用環境はロースペックの '''Windows XP sp3 (32bit), JScript 5.8.20587''' のノート PC です。
* sukemaru の Mery 運用環境はロースペックの '''Windows XP sp3 (32bit), JScript 5.8.20587''' のノート PC です。
: ※ 制作したマクロの動作テストは、この XP 機でしかおこなっていません。
: ※ 制作したマクロの動作テストは、この XP 機でしかおこなっていません。
811行目: 877行目:
: ※ [http://k-takata.o.oo7.jp/mysoft/bregonig.html bregonig] の正規表現のハイライト可 (基本的に [https://github.com/k-takata/Onigmo/blob/master/doc/RE.ja onigmo] の正規表現にも利用可)
: ※ [http://k-takata.o.oo7.jp/mysoft/bregonig.html bregonig] の正規表現のハイライト可 (基本的に [https://github.com/k-takata/Onigmo/blob/master/doc/RE.ja onigmo] の正規表現にも利用可)
: ※ 収録しなかった正規表現タグ (文字・文字種の変数など) がある。 → リンク先ページ末尾の注記を参照のこと
: ※ 収録しなかった正規表現タグ (文字・文字種の変数など) がある。 → リンク先ページ末尾の注記を参照のこと
 
<br><br>
 
[[#TOP|>> 目次へ]]
[[#TOP|>> 目次へ]]
 
<br><br>


= スクショ =
= スクショ =
スポンサーリンク