「TAB／半角空白トグル変換」を編集中 (節単位)

== 設定項目 ==
'''<code>indentSize</code>'''　(初期値: '''0''')<br>
「タブの桁数」（半角空白で何コ分の幅か）を数値で指定します。
: 変更する場合は、[オプション] ダイアログ　>>　[基本] カテゴリ の「タブの桁数」の設定値で指定してください。

: ''e.g.''　<code>indentSize = 4</code> で「半角空白６コ」の選択範囲を変換すると「TAB１コ＋半角空白２コ」になります。

* '''<code>indentSize = 0</code>''' なら「タブの桁数」を Mery から自動取得します。
: Mery Ver 3 以降では <code>Document.IndentSize</code> プロパティでの取得を試行します。 <code>Document.IndentSize</code> を取得できなかった場合や Mery Ver 2.x では Mery.ini から「タブの桁数」を読みこみます。

'''<code>wholeLines</code>'''　(初期値: '''true''')<br>
論理行全体（複数行可）の「TAB ⇔ 半角空白」変換を許可するかしないかのオプションです。
: <syntaxhighlight lang="javascript" inline>wholeLines = true</syntaxhighlight> のときで、選択範囲がなくキャレット位置に変換対象になる空白文字列がない場合や、選択範囲があっても変換対象になる空白文字列がない（または半角空白の数が「タブの桁数」に満たない）場合、選択範囲に非空白文字（全角空白や改行も）がふくまれている場合は、論理行全体を選択範囲にして「TAB ⇔ 半角空白」の変換を試行します。
* Mery の標準コマンドの「タブを空白に変換」と「空白をタブに変換」で処理するので複数行の範囲選択状態からでも変換可能ですが、つねに論理行全体、論理行内のすべての TAB とすべての連続する半角空白が対象となります。
* トリプルクリックや行番号のクリックまたはドラッグで「行全体＋末尾改行のある範囲選択状態」から実行したとき、ひとつ下の行は変換対象になりません。

'''<code>FullToHalf2</code>'''　(初期値: '''false''')<br>
全角空白を「空白をタブに変換」の対象に含めるためのオプションです。
* 設定項目で <syntaxhighlight lang="javascript" inline>FullToHalf2 = true</syntaxhighlight> にすると全角空白を「半角空白×2」とみなして「空白 ⇒ TAB」変換します。
* さいしょに「全角空白 ⇒ 半角空白×2」変換してから「TAB ⇒ 半角空白」「空白 ⇒ TAB」の順に試行します。
以下の理由によりあまり役に立つ機能ではなさそうなので、初期値を <syntaxhighlight lang="javascript" inline>false</syntaxhighlight> に設定してあります。
* 「全角空白 ⇒ 半角空白×2」の変換は一方通行（'''不可逆'''）です。
* このマクロの基本プランが「TAB ⇔ 半角空白」の相互変換であるため、「全角空白 ⇒ 半角空白×2」変換は単独的機能として設計していません。 全角空白をふくむ選択範囲から「全角空白 ⇒ 半角空白×2」変換した「連続する半角空白」の先頭が TAB の区切り位置にあれば、「空白 ⇒ TAB」変換します。
* このマクロは「連続する全角空白」や、「全角空白」と「半角空白や TAB」 と混在する文字列では、空白文字列すべてを自動選択することはできません。 あらかじめ範囲選択してから実行する必要があります。
: ※ 「[[拡張自動選択]]」マクロか「[[TrueとFalse を切り替える|Yes／No マクロ]]」で「全角空白をふくむ空白文字列」全体を自動選択可。
* 「行全体」オプションが有効な場合、ソースコード内で全角の <code>"　"</code> でなければならない部分が壊れる（半角空白×２に変換される）ことがあります。
: 設定項目 <syntaxhighlight lang="javascript" inline>var wholeLines = true</syntaxhighlight> で利用する場合、<code>FullToHalf2</code> は無効（<code>false</code>）にすることをお勧めします。