「次／前の文字列を検索・改」の版間の差分

__toc__

== 次／前の文字列を検索・改 ==

; ダウンロード　>>　「[[メディア:次／前の文字列を検索・改.zip|次／前の文字列を検索・改.zip]]」（アイコン入り）

=== 機能 ===

[https://www.haijin-boys.com/software/mery/mery-tips#2 ショートカットキー [ Ctrl＋Shift＋ ↓ または ↑ ]] の「[[ヘルプ:検索#次の文字列を検索|次／前の文字列を検索]]」コマンドの機能をカスタマイズしたマクロです。

*'''選択範囲が改行をふくむ複数行'''（論理行）のばあいでも「次／前の文字列を検索」と同様のジャンプ機能がほしい

という個人的希望を実現する目論見です。

=== 設定項目 ===

このマクロの特色（上記の <q>目論見</q>）を有効にするなら

* '''''optionEnable''' = <b style="color:#c00;">false</b>''

* '''''multiLinesEnable''' = <b style="color:#0000c0;">true</b>''

での運用をお勧めします（その他の設定項目はお好みで）。

----

'''▼ 優先オプション ▼'''

==== 設定項目： ''findNext'' ====

* <b style="color:#0000c0;">"Next"</b> なら「次（下）の文字列を検索」

: ※ 実際のところ "Next"、"Down"、true、1 のいずれかなら「次」、それ以外の値なら「前」になるようにしてあります。

: ※ ZIP 書庫を [[#ダウンロード|ダウンロード]] した場合、あらかじめ「次」と「前」ふたつの JS ファイルを用意してあります。

==== 設定項目： ''optionEnable'' ====

「検索」ダイアログのオプションフラグを使用するかしないかを指定します。

<div class="warningbox">  

</div>

* <b style="color:#0000c0;">true</b> なら、カスタマイズなしで、ショートカットキー [ Ctrl＋Shift＋ ↓ / ↑ ] の機能そのままに「次／前の文字列を検索」のジャンプを実行します。

: ※ ジャンプした後も、「検索」ダイアログに検索文字列の履歴が残ります。

: ※ このマクロからは「検索」ダイアログのオプションフラグを取得できないので、設定項目 '''''[[#設定項目： hitCountEnable|hitCountEnable]]''' = <b style="color:#0000c0;">true</b>'' にする場合、ヒット件数は '''''matchCaseEnable''''' と '''''onlyWordEnable''''' の設定状態にしたがってカウントします。

* <b style="color:#c00;">false</b> なら、「検索」ダイアログのオプションフラグを一度リセットしてから「次／前の文字列を検索」と同様のジャンプを実行します。

:* 「単語のみを検索する」

:* 「文末まで検索したら文頭に移動する」

: ※「大文字と小文字を区別する」「単語のみを検索する」「文末まで検索したら文頭に移動する」については、個別の変数をもうけて再設定可能にしてあります。

: ※ ジャンプの後、「検索」ダイアログに検索文字列の履歴を残しません。

: ※ <b style="color:#c00;">false</b> にすると「検索」ダイアログに検索文字列の最新の履歴は空になるので、つづけて <span style="color:#c00;">ショートカットキー操作での「次を検索 (F3)」と「前を検索 (Shift+F3)」のジャンプはできません</span>（検索ダイアログが開きます）。

==== 設定項目： ''highlightEnable'' ====

: ※「検索文字列の強調表示」を手動で解除するのが面倒な人は <b style="color:#c00;">false</b> にしてください。

: ※「自動マーカー」が有効なら自動マーカーによる強調表示は残ります。

==== 設定項目： ''hitCountEnable'' ====

* <b style="color:#c00;">false</b> なら、検索ヒット数を表示しません。

: ※ 別途で「検索ヒット数表示」マクロのような「選択範囲が変更された時」にステータス表示するイベントマクロを使用しているばあいは、イベントマクロによってステータス表示が上書きされます。

'''▲ 優先オプション ▲'''

----

'''▼ ''optionEnable = <span id="false2" style="color:#c00;">false</span>'' のとき ▼'''

==== 設定項目： ''findAroundEnable'' ====

* <b style="color:#0000c0;">true</b> なら、「'''文末まで検索したら文頭に移動する'''」オプションを適用して、「次／前の文字列を検索」と同様のジャンプ機能を実行します。

: ※ 「検索／置換」ダイアログ内の「文末まで検索したら文頭に移動する」オプションは、ジャンプ後も有効化されたままになります。

==== 設定項目： ''matchCaseEnable'' ====

* <b style="color:#0000c0;">true</b> なら、「'''大文字と小文字を区別する'''」オプションを適用して「次／前の文字列を検索」と同様のジャンプ機能を実行します。

: ※ 「検索／置換」ダイアログ内の「大文字と小文字を区別する」オプションは、ジャンプ後も有効化されたままになります。

==== 設定項目： ''onlyWordEnable'' ====

: ※ 「検索／置換」ダイアログ内の「単語のみ検索する」オプションは、ジャンプ後も有効化されたままになります。

: <span style="color:#0000c0;">※ 実質的に「単語のみ検索」オプションが有効になるのは、検索文字列が「'''英単語のみ''' (半角アルファベットと半角数字のみ)」のときだけです。</span> 検索文字列にアンダーバー　<q>_</q>　以外の記号や空白文字、 ascii 外の文字がふくまれるばあいは、'''''onlyWordEnable''' = <b style="color:#0000c0;">true</b>'' であっても「単語のみ」オプションの ON／OFF 状態は無視されます（Mery 本体の仕様と同様）。

==== 設定項目： ''multiLinesEnable'' ====

* <b style="color:#0000c0;">true</b> なら、選択範囲が複数行でも「次／前の文字列を検索」と同様のジャンプができます。

: ※ 選択範囲が改行記号をふくむ複数行の状態からジャンプしたばあいは、'''''highlightEnable''' = <b style="color:#0000c0;">true</b>'' であっても「検索文字列の強調表示」はされません（Mery 本体の仕様）。 また、Mery 本体の「自動マーカー」機能による強調表示もされません。

* <b style="color:#c00;">false</b> で選択範囲が複数行だったばあいは、選択範囲をいったん解除してから、あらためてキャレット付近の '''単語''' を自動選択して「次／前の文字列を検索」と同様のジャンプをします。

'''▲ ''optionEnable = <span style="color:#c00;">false</span>'' のとき ▲'''

=== ダウンロード ===

ダウンロード　>>　「[[ファイル:次／前の文字列を検索・改.zip]]」

* マクロ「次の文字列を検索・改.js」

* マクロ「前の文字列を検索・改.js」

* 専用アイコン（マテリアルデザインっぽいアイコン）

; 変更履歴

: 検索方向「次／前」を変数で指定

: 検索ヒット数のステータス表示機能を追加

: ソースコードが長くなったので、ZIP 書庫をアップロード

=== ソースコード ===

<syntaxhighlight lang="javascript" style="height:80em; overflow:auto;">

#title  = "次の文字列を検索"

  * ----------------------------------------------

  * 「次／前の文字列を検索・改」

  * https://www.haijin-boys.com/wiki/次／前の文字列を検索・改

  * ----------------------------------------------

  * ※ 実行後は「検索／置換」ダイアログ内の「正規表現」オプションは OFF になる

  *  

  * ・矩形選択・複数選択で optionEnable=true を強制適用

  * ・複数行検索で検索オプションを維持（定数 meFindKeepOptions を適用）

}

</syntaxhighlight>

== 次／前の文字列を検索・改 ２ ==

=== 改２の機能 ===

Mery 標準機能の '''検索文字列の強調表示''' の状態（ハイライトされた文字列）を変更せずに検索・ジャンプしたい方は、こちらの「次／前の文字列を検索・改 ２」マクロをお試しください。

<br>

: ※ <span style="color:#c00;">マルチカーソルには非対応 </span>につき、マルチカーソル・複数選択範囲の状態から実行した場合は Mery 標準機能の「次／前の文字列を検索」コマンドを試行します （検索履歴やハイライト状態が変更されます）。

: ※ Javascript／JScript の機能で検索・ジャンプをおこなうため、<span style="color:#c00;">古い OS</span> や <span style="color:#c00;">低スペックの PC</span> 環境、かつ、<span style="color:#c00;">長大な文書（ドキュメント）</span>では動作がやや遅い場合があります。

「[[#次／前の文字列を検索・改|次／前の文字列を検索・改]]」マクロの [[設定項目]] のうち、４項目

  var [[#設定項目： optionEnable|optionEnable]] = false;

<br>

検索ダイアログのオプション項目「文末まで検索したら文頭に移動する」「大文字と小文字を区別する」「単語のみ検索する」にあたる <b><code>findAroundEnable</code> <code>matchCaseEnable</code> <code>onlyWordEnable</code></b> と検索文字列の出現回数のステータス表示設定 <b><code>hitCountEnable</code></b> の <syntaxhighlight lang="javascript" inline>true</syntaxhighlight>/<syntaxhighlight lang="javascript" inline>false</syntaxhighlight> 、長大な文書で動作が遅くなる場合の回避設定 <b><code>maxLength</code></b> の数値を任意にカスタマイズしてご利用ください。

=== 改２のダウンロード ===

ダウンロード　>>　「[[ファイル:次／前の文字列を検索・改_２.zip]]」

* マクロ「次の文字列を検索・改２.js」

* マクロ「前の文字列を検索・改２.js」

* 専用アイコン（マテリアルデザインっぽいアイコン）

; 変更履歴

=== 改２のソースコード ===

  * ----------------------------------------------

  * 「次／前の文字列を検索・改 ２」

  * https://www.haijin-boys.com/wiki/次／前の文字列を検索・改#次／前の文字列を検索・改_２

  * ----------------------------------------------

  * ・検索ヒット数をステータス表示可

  *  

  *  Mery 標準機能の「次／前の文字列を検索」コマンドでのジャンプを試行する

  * （検索ダイアログのオプションを適用し、検索履歴に残る）

}

</syntaxhighlight>

== メモ ==

Mery 標準機能の「次／前の文字列を検索」コマンドをそのままマクロ化（→ ツールバーアイコン化）する場合

<syntaxhighlight lang="javascript">

editor.ExecuteCommandByID( 2137 );

</syntaxhighlight>

----

*個人的には、通常の「次／前の文字列を検索」コマンドのショートカットキー [ Ctrl＋Shift＋ ↓ または ↑ ] は変更せず、このマクロ（検索強調なし）はツールバーアイコンからの実行専用にして、検索強調の要否で使い分けています。(sukemaru)

*「単語のみ検索する」にあわせた検索ヒット数表示用の関数　''WordHitStatus()''　の正確度について、あまり自信がありません （ふだん「単語のみ検索」を利用していないため）。 なにがしかの問題または改善点を見つけた方は、[https://www.haijin-boys.com/discussions Mery 公式フォーラム] などからお知らせください。(sukemaru)

----