「利用者:Sukemaru」を編集中 (節単位)

=== 文字列操作が空振りしたときは undo 履歴に残さない ===
* 条件付きで文字列操作（挿入・置換など）するマクロが空振りしたとき
<syntaxhighlight lang="javascript">
// e.g. 選択範囲に「hoge」が含まれていれば「fuga」に置換する
var fuga = document.selection.Text.replace( /hoge/g, "fuga" );
document.selection.Text = fuga;
</syntaxhighlight>
: 上のようなコードの場合は '''undo''' 履歴に無駄に残ったり、文書に「'''未保存 *'''」のフラグが付加されたりする。

: 以下のように「文字列操作の前後で "変化なし" なら undo 履歴には残さない」記述にすると、[https://www.haijin-boys.com/software/mery/mery-2-6-9#4 変更行の強調表示] なども無用に付かなくなる。
<syntaxhighlight lang="javascript">
// e.g. 選択範囲に「hoge」が含まれなければ置換しない
var st = document.selection.Text;
var piyo = st.replace( /hoge/g, "piyo" );

if ( st != piyo ) {
  document.selection.Text = piyo;
}
</syntaxhighlight>

* 大文字／小文字変換の [[マクロリファレンス:Selection インターフェイス#ChangeCase メソッド|Selection.ChangeCase() メソッド]] や、全角／半角変換の [[マクロリファレンス:Selection インターフェイス#ChangeWidth メソッド|Selection.ChangeWidth() メソッド]] なども、日本語文などで空振りしたときに undo 履歴に残るが、上のサンプルコードのようなかたち <syntaxhighlight lang="javascript" inline>var temp = document.selection.ChangeCase( meCaseLowerCase );</syntaxhighlight> で変数に格納することはできない。
: [[マクロリファレンス:Selection インターフェイス|Document.Selection クラス]] の文字列操作メソッドの場合は、以下のように記述することで「<span style="color:#0000c0;">変換なしなら undo 履歴を巻き戻し</span>」できる。

<syntaxhighlight lang="javascript">
// 変換前の文字列 と 保存済み／未保存 の状態を取得
var st = document.selection.Text;
var sv = document.Saved;

if ( st && ! document.ReadOnly ) {

  // 小文字に変換
  document.selection.ChangeCase( meCaseLowerCase );

  // 変換なしなら undo 履歴を巻き戻す
  if ( document.selection.Text == st ) {
    document.Undo();
    document.Saved = sv;
  }
}
</syntaxhighlight>
: ※ ただし、厳密にいえば undo 履歴には残っているので、'''redo''' (やり直し： Ctrl+Y) することができる。