Sukemaru (トーク | 投稿記録)
編集の要約なし
Sukemaru (トーク | 投稿記録)
編集の要約なし
116行目: 116行目:
== リンク ==
== リンク ==
* [[マクロライブラリ#その他|マクロライブラリ]] にある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
* [[マクロライブラリ#その他|マクロライブラリ]] にある ks 氏らの「[[マクロ覚え書き(開発者向け)|マクロ覚え書き]]」
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」 <br>
* 黄身氏の「[[利用者:黄身#覚え書き|覚え書き]]」
<br>
* MeryWiki の [[マクロリファレンス]]
* MeryWiki の [[マクロリファレンス]]
* [https://www.haijin-boys.com/discussions Mery 公式フォーラム] <br>
* MeryWiki の [[よくある質問|FAQ]]
* MDN web docus(mozzila)の [https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference JavaScript リファレンス] <br>
* [https://www.haijin-boys.com/discussions Mery 公式フォーラム]  
<br>
* 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/cc392483(v=msdn.10) Microsoft Windows スクリプト テクノロジ]
* 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 ランゲージ リファレンス]
* MSDN(Microsoft Docs)の [https://docs.microsoft.com/ja-jp/previous-versions/windows/scripting/cc409859%28v%3dmsdn.10%29 JScript ランゲージ リファレンス]
162行目: 166行目:
ポップアップメニューのラベルの文字列に「半角アンパサンド記号('''&''') + 半角英数字 (またはアスキー記号)」を付記することで、アクセラレータ(アクセスキー)を設定することができる。<br>
ポップアップメニューのラベルの文字列に「半角アンパサンド記号('''&''') + 半角英数字 (またはアスキー記号)」を付記することで、アクセラレータ(アクセスキー)を設定することができる。<br>
ラベルの先頭に連番数字などがある場合は、アンパサンド記号を付加することで、数字をアクセラレータにするとよい。<br>
ラベルの先頭に連番数字などがある場合は、アンパサンド記号を付加することで、数字をアクセラレータにするとよい。<br>
そのさい、Shift キー付きでの入力が必要な記号は Shift キーなしで入力可能なキーのラベルと同一視される (e.g. 「&#」で "'''#'''" 記号をアクセラレータに指定した場合、JIS 配列のキーボードでは ['''2'''] キーがアクセラレータになる)。<br>
そのさい、Shift キー付きでの入力が必要な記号は Shift キーなしで入力可能なキーのラベルと同一視される (e.g. 「'''&#'''」で "'''#'''" 記号をアクセラレータに指定した場合、JIS 配列のキーボードでは ['''2'''] キーがアクセラレータになる)。<br>
また、「& 」(半角アンパサンド+半角空白) で半角スペースをアクセラレータに指定したアイテムは、スペースキーがアクセスキーになる。
また、「'''& '''」(半角アンパサンド+半角空白) で半角スペースをアクセラレータに指定したアイテムは、スペースキーがアクセスキーになる。


* <span style="color:#c00;">"'''&'''" 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の "'''&'''" 記号のうしろの文字がアクセラレータになる</u></span>( … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある)。
* <span style="color:#c00;">"'''&'''" 記号でアクセラレータ化する文字の位置は限定されないが、<u>最初の "'''&'''" 記号のうしろの文字がアクセラレータになる</u></span>( … とおもわれる ← ポップアップメニュー内で「下線つきで表示される文字」と一致しないことがある)。
* <span style="color:#c00;">全角文字はアクセラレータにできない。</span>
* <span style="color:#c00;">全角文字はアクセラレータにできない。</span>
* <span style="color:#c00;">ラベル文字列に含まれる "'''&'''" 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに "'''&'''" 記号を表示させたいときは、"'''&&'''" のように二重に記述する必要がある。</span><br> → 不特定の文字列をラベルにする場合は、あらかじめ String.replace( /&/g, "&&" ) と記述するとよい。
* <span style="color:#c00;">ラベル文字列に含まれる "'''&'''" 記号はすべてエスケープされてしまい、ポップアップメニューには表示されなくなるので、ラベルに "'''&'''" 記号を表示させたいときは、"'''&&'''" のように二重に記述する必要がある。</span><br> → 不特定の文字列をラベルにする場合は、あらかじめ ''String.replace( /&/g, "&&" )'' と記述するとよい。
* <span style="color:#c00;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(→ [Enter] キーで決定する)。</span>
* <span style="color:#c00;">同じキーが重複してアクセラレータに指定されていると、そのキーを押した場合、アイテム間をトグル移動する(→ その場合は [Enter] キーで決定する)。</span><br> → アイテム数が多くなるメニューの場合、''menu.Add( "キャンセル & ", 0 );'' という行を 10 件とか 20 件ごとに挿入すると、スペースキーでポップアップメニュー内をスクロールさせることができる。
<source lang="javascript">
<source lang="javascript">
/* アクセラレータを付加する */
var menu = CreatePopupMenu();
var menu = CreatePopupMenu();
var piyo = "LOVE & PEACE & ...";
var piyo = "LOVE & PEACE & ...";
180行目: 186行目:
menu.Add( piyo + "(&6)", 6 ); // スペースキーがアクセラレータ
menu.Add( piyo + "(&6)", 6 ); // スペースキーがアクセラレータ
menu.Add( "※※※※", 0, meMenuSeparator ); // meMenuSeparator があると第一引数の文字列は無視される
menu.Add( "※※※※", 0, meMenuSeparator ); // meMenuSeparator があると第一引数の文字列は無視される
menu.Add( "キャンセル & ", 0 ); // スペースキーがアクセラレータ
menu.Add( "キャンセル & ", 0 ); // スペースキーがアクセラレータ


// 5つめのアイテムは "LOVE & PEACE & ..." と表示されるが
// 5つめのアイテムは "LOVE & PEACE & ..." と表示されるが
// 6つめのアイテムは "LOVE  PEACE  ..." と表示される  
// 6つめのアイテムは "LOVE  PEACE  ..." と表示される  
// ※ 5つめのアイテムと最後のアイテムでアクセラレータが重複している


var ret = menu.Track();
// ※ 6つめのアイテムと最後のアイテムでアクセラレータが重複している
 
var ret = menu.Track( 0 );
</source>
<source lang="javascript">
/* 10行ごとに「キャンセル」項目を挿入し、スペースキーでスクロール可能にする */
 
var arr = Document.Text.split( "\n" );
var menu = CreatePopupMenu();
 
for ( var i = 0; i < arr.length; i ++ ) {
  if ( i > 0 && i % 10 == 0 ) {
    menu.Add( "", 0, meMenuSeparator );
    menu.Add( "キャンセル & ", 0 );
    menu.Add( "", 0, meMenuSeparator );
  }
  menu.Add( arr[i].slice( 0, 30 ), i + 1 );
}
 
var y = menu.Track( 0 );
if ( y ) {
  Document.Selection.SetActivePoint( mePosLogical, 1, y );
}
</source>
</source>




=== ラベルの整形 ===
=== ラベルの整形 ===
ポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている)。<br>
基本的にポップアップメニュー(警告・確認ダイアログなどもだが)は UI フォントで表示されるので、文字列が英数字の羅列の場合には読みづらい ( …と個人的に感じている)。<br>
文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。
文書内の文字列など不特定の文字列をラベル化する「[[ポップアップメニューで検索先にジャンプ#sukemaru 版|検索ジャンプ]]」や「[[ブックマーク一覧ジャンプ#sukemaru 版|ブックマークジャンプ]]」、「[[「クリップボード履歴」メニューのマクロ化|クリップボード履歴メニュー]]」マクロでは、読みづらい半角アルファベットや記号を全角化させるなどしている。
<source lang="javascript">
<source lang="javascript">
200行目: 227行目:
  *  
  *  
  * ・行頭空白を除去
  * ・行頭空白を除去
  * ・空白文字を圧縮: →「›」(U+203A) に置換
  * ・空白文字を圧縮: →「›」(U+203A) に置換
  * ・文字数を切り詰め(String.slice メソッド)
  * ・文字数を切り詰め(String.slice メソッド)
  * ・改行記号を可視化: →「⏎」(U+23CE)に置換
  * ・改行記号を可視化: →「⏎」(U+23CE) に置換
  * ・削られてしまう「&」を補完
  * ・削られてしまう「&」を補完
  * ・「¥」(U+005C) を「∖」(U+2216) に置換
  * ・「¥」(U+005C) を「∖」(U+2216) に置換
237行目: 264行目:
// ※ 連番が多い場合は「番号を空白文字でケタ埋め (右端揃え)」などの処理も追加するとよい
// ※ 連番が多い場合は「番号を空白文字でケタ埋め (右端揃え)」などの処理も追加するとよい
</source>
</source>
ただし、Mery のダイアログのフォントは Mery.ini の「[[よくある質問#ダイアログのフォントを変更したい|隠しオプション]]」により任意のフォントに変更可なので、個人的にしか使わない非公開マクロであれば気にする必要はないかも。




=== 配列からポップアップメニューを生成 ===
=== 配列からポップアップメニューを生成 ===
[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/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( "" ); // 先頭に空のダミー要素を入れておく
265行目: 295行目:
=== サブメニュー ===
=== サブメニュー ===
* 配列やオブジェクトからポップアップメニューを生成するさいにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、要素が不定数の配列やオブジェクトをサブメニューに振り分けるのは簡単ではない。
* 配列やオブジェクトからポップアップメニューを生成するさいにサブメニューを利用する場合、あらかじめサブメニューのラベルや各要素の振り分け方が決まっていれば難しいことはないが、要素が不定数の配列やオブジェクトをサブメニューに振り分けるのは簡単ではない。
<br>
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
: 「[[階層化マクロメニュー]]」マクロなどのソースコードを参考にしてコードを組むか、組み込み関数「[[ポップアップメニューを「n*十件ずつ」のサブメニューに自動分割する]]」で一定数ごとにサブメニュー項目を自動生成して要素を放り込むしかない…。
<br>
<br>
274行目: 305行目:
=== マクロの動作設定を変更可能にする ===
=== マクロの動作設定を変更可能にする ===
拙作マクロは、ポップアップメニューを使うものにかぎらず動作設定用の項目が多い。<br>
拙作マクロは、ポップアップメニューを使うものにかぎらず動作設定用の項目が多い。<br>
ポップアップメニューマクロでないものは、通常、頻繁に動作設定を弄る必要はないが、sukemaru 好みの動作方式は一般的嗜好と合致しないであろうことから公開用のマクロにするにあたってカスタマイズ可能な「設定項目」に調整しなおすことが多い。
ポップアップメニューマクロでないものは、通常、頻繁に動作設定を弄る必要はないが、sukemaru 好みの動作方式は一般的嗜好と合致しないであろうことから公開用のマクロにするにあたってカスタマイズ可能な「設定項目」に調整しなおすことが多い…。
<br><br>
<br><br>
ポップアップメニューマクロであれば、メニュー項目から動作設定をカスタマイズできるようにコーディングすることができる。
ポップアップメニューマクロであれば、メニュー項目から動作設定をカスタマイズできるようにコーディングすることができる。
281行目: 312行目:
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。
: 動作設定の変更内容はマクロの完了時に破棄されてしまうので、連続して同じマクロを利用する場合には、ソースコードの既定値を書き換えてカスタマイズしておくとよい。
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読み直す・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。
* sukemaru の場合は、「[[ポップアップメニューで検索先にジャンプ#include版|検索ジャンプ]]」「[[ブックマーク一覧ジャンプ#include版|ブックマークジャンプ]]」や「[[ファイルを読み直す・開きなおす#include版|読みなおし]]」マクロなどで、【include 版】と称するものを作っている。
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の Serialize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。
: これらにおいては、[[includeライブラリ|include ライブラリ]] の IO クラス(IO.js)の関数メソッド Serialize() / Deserialize() を利用して、ポップアップメニュー内の「設定変更」サブメニューから変更した設定値を外部ファイル(JSON ファイル)に保持できるようにしている。
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
: 動作設定を同じままで再実行するのも、カスタマイズしながら再実行するのも容易にはなったが、コードが煩雑になって他のマクロに流用しづらくなってしまっている…。
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。
: ※ 非 include 版では、「設定変更」サブメニューや masme 氏のマクロのような処理コードは入れず、動作設定の変更方法はソースコードの変数の値の書き換えのみとしている。
306行目: 337行目:


== Collapse() メソッド とキャレット位置 ==
== Collapse() メソッド とキャレット位置 ==
[[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Selection.Collapse() メソッド]] で引数 ''meCollapseEnd'' を指定した場合は
[[マクロリファレンス:Selection インターフェイス#Collapse メソッド|Selection.Collapse() メソッド]] で引数 '''''meCollapseEnd''''' を指定した場合は
  Selection.SetActivePos( Selection.GetActivePos() )  
  Selection.SetActivePos( Selection.GetActivePos() )  
''meCollapseStart'' を指定した場合は
'''''meCollapseStart''''' を指定した場合は
  Selection.SetActivePos( Selection.SetAnchorPos() )
  Selection.SetActivePos( Selection.SetAnchorPos() )
と意味的には同じである。
と意味的には同じである。
314行目: 345行目:
※ 引数を省略した場合は ''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>


332行目: 363行目:
  &#32;8: meFindAround 文書の末尾まで検索したら先頭から検索を開始します。
  &#32;8: meFindAround 文書の末尾まで検索したら先頭から検索を開始します。
  16: meFindReplaceRegExp 正規表現で検索します。
  16: meFindReplaceRegExp 正規表現で検索します。
 
<br><br>
: 「検索/置換」ダイアログのオプションフラグをすべて OFF にする方法として
: 「検索/置換」ダイアログのオプションフラグをすべて OFF にする方法として
<source lang="javascript">
<source lang="javascript">
338行目: 369行目:
</source>
</source>
: というコードを挟み込むという手がある(第二引数には 0 または 1 を指定する)。
: というコードを挟み込むという手がある(第二引数には 0 または 1 を指定する)。
: これは、マクロ実行時に「[[ヘルプ:検索|検索/置換]]」ダイアログが開かれていないときにかぎり、マクロ終了後の「検索/置換」ダイアログのオプション項目のチェック ON/OFF の状態にも引き継がれる(次回の「検索/置換」や「[[ヘルプ:検索#次を検索|次/前を検索]]」「[[ヘルプ:検索#次の文字列を検索|次/前の文字列を検索]]」コマンドなどに引き継がれる)。
: これは、マクロ実行時に「[[ヘルプ:検索|検索/置換]]」ダイアログが開かれていないときにかぎり、マクロ終了後の「検索/置換」ダイアログのオプション項目のチェック ON/OFF の状態にも引き継がれる(次回の「検索/置換」や「[[ヘルプ:検索#次を検索|次/前を検索]]」「[[ヘルプ:検索#次の文字列を検索|次/前の文字列を検索]]」コマンドなどにも引き継がれる)。


: ※ ただし、「終了したら閉じる」と、[https://www.haijin-boys.com/software/mery/mery-2-6-10#1 ベータ版 2.6.10] で追加された「インクリメンタルサーチ」のオプションフラグはマクロから解除することができない。
: ※ ただし、「終了したら閉じる」と、[https://www.haijin-boys.com/software/mery/mery-2-6-10#1 ベータ版 2.6.10] で追加された「インクリメンタルサーチ」のオプションフラグはマクロから解除することができない。
352行目: 383行目:
  &#32;2: meFindRepeatWord 選択範囲が空の場合はカーソル位置の単語を検索します。
  &#32;2: meFindRepeatWord 選択範囲が空の場合はカーソル位置の単語を検索します。


: FindRepeat() メソッドでは定数 ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround , meFindReplaceRegExp'' が使用できないが、<span style="color:#0000c0;">'''直前'''の「検索/置換」コマンドや Find() / Replace() メソッドで使用したこれらのオプションのうち ''meFindReplaceRegExp'' 以外の三つの ON/OFF 状態が'''継承'''される。</span>
: FindRepeat() メソッドでは定数 ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround , meFindReplaceRegExp'' が使用できないが、 <span style="color:#0000c0;">'''直前''' の「検索/置換」コマンドや Find() / Replace() メソッドで使用したこれらのオプションのうち ''meFindReplaceRegExp'' 以外の三つの ON/OFF 状態が '''継承''' される。</span>


: よって、FindRepeat() メソッドで ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround'' を適用した検索をしたいばあいは、以下のように記述する。
: よって、FindRepeat() メソッドで ''meFindReplaceCase'' や ''meFindReplaceOnlyWord , meFindAround'' を適用した検索をしたいばあいは、以下のように記述する。
362行目: 393行目:
// 2.「前回検索した文字列を検索」または キャレット位置の単語で「次の文字列を検索」
// 2.「前回検索した文字列を検索」または キャレット位置の単語で「次の文字列を検索」
document.selection.FindRepeat( meFindNext + meFindRepeatWord );
document.selection.FindRepeat( meFindNext + meFindRepeatWord );
// -------------------------------------------------- //


// 3.最後にオプションフラグを解除しておきたいなら
// 3.最後にオプションフラグを解除しておきたいなら
document.selection.Find( "", 0 );
document.selection.Find( "", 0 );
</source>
</source>
: ref. 『[https://www.haijin-boys.com/discussions/3398 空検索の動作、など]』




393行目: 427行目:


※ スクロールマージンは [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]
== 変換・挿入した文字列を範囲選択するとき ==
<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>
※ CharLeft( str.length, true ) の場合、文字列 ''str'' が「折り返し」にかかってしまったときに想定どおりの選択範囲にならない。
: ref. 『[https://www.haijin-boys.com/discussions/3740 "折り返し表示" での CharRight( document.selection.Text.length - 1 ) について]』
== 複数行の論理行を範囲選択(末尾改行を含まない) ==
: ref. 『[https://www.haijin-boys.com/discussions/4431 マクロについてアドバイスお願いします]』
== 文字列操作が空振りしたときは undo 履歴に残さない ==
条件付きで文字列操作(挿入・置換など)するマクロ
<source lang="javascript">
// e.g. 選択範囲に「hoge」が含まれなければ置換しない
var fuga = document.selection.Text.replace( /hoge/g, "fuga" );
document.selection.Text = fuga;
</source>
が空振りしたときに、上のようなコードの場合は '''undo''' 履歴が無駄に残ったり、文書に「'''未保存 *'''」のフラグが付加されたりする(大文字/小文字変換の [[マクロリファレンス:Selection インターフェイス#ChangeCase メソッド|ChangeCase() メソッド]] や全角/半角変換の [[マクロリファレンス:Selection インターフェイス#ChangeWidth メソッド|ChangeWidth() メソッド]] なども、日本語文などでは空振りするが undo 履歴に残る)。
<br><br>
<br><br>
「文字列操作の前後で "変化なし" なら undo 履歴には残さない」ようにコーディングすると、[https://www.haijin-boys.com/software/mery/mery-2-6-9#4 変更行の強調表示] なども無用に付かなくなる。
<source lang="javascript">
// e.g. 選択範囲に「hoge」が含まれなければ置換しない
var st = document.selection.Text;
var piyo = st.replace( /hoge/g, "piyo" );
if ( st != piyo ) {
  document.selection.Text = piyo;
}
</source>


== カレントディレクトリ ==
== カレントディレクトリ ==
スポンサーリンク