last updated:2024/11/17

Hidemaru Q and A

第II部〜知っていると便利な秀丸の機能
　単語補完

単語補完

秀丸エディタ Ver.7.00以降では「単語補完」が使用可能です。

「単語補完」は、入力された文字から始まる単語をリストアップする機能です。

補完の元となるデータは、以下を指定できます。

追加の辞書としては、以下が指定可能です。

候補を表示する方法も複数用意されているので、好みで設定してください。

[解説]

「単語補完」の設定は、以下の2箇所あります。

  • 共通の設定である「動作環境」
  • ファイルタイプ別に設定する「ファイルタイプ別の設定」

「動作環境」-「編集」-「単語補完」

編集-単語補完

自動表示関連の設定
  • 入力してから候補を表示するまでの待ち時間を、「ミリ秒単位」で設定します。
    入力してからこの時間が経過すると、候補を表示します。
  • 候補表示開始する入力文字数
    設定した文字数を入力すると、候補を表示します。文字数が少ないと候補が多くなります。文字数が多ければ、候補は絞り込まれます。
  • 自動表示の表示方法がツールチップの場合、ツールチップに表示する最大個数を設定します。
特殊なキー操作

本来、「単語補完上キー」「単語補完下キー」はリスト表示されている場合、選択を上下移動させるキー操作です。補完対象リストが表示されていない状態では無効になるはすですが、別途機能を割り当てることが出来ます。

  • 標準 （リスト表示）
    「リスト表示」と同じです。

  • リスト表示
    設定が「リスト」以外でも、リスト表示を行います。

  • リストを非表示のまま選択
    リストは表示されませんが、キーを押すたびに、候補リストの内容に切り替わります。

  • 現在の内容の上下検索
    設定にかかわらず、「現在の内容」から候補を検索します。

    • 「単語補完上キー」の場合はカーソルキーより上方向を検索。
    • 「単語補完下キー」の場合はカーソルキーより下方向を検索。

  • 現在の内容の上下検索と他の候補
    「現在の内容の上下検索」だけではなく、「ファイルタイプ別の設定」で「追加の対象」に設定された内容から、候補を検索します。

  • タブキーの割り当て
    タブキーと同じ動作にします。

数字キーによる候補の選択について設定します。

  • Alt+1〜9 (キー割り当て有効)
    Alt+1〜9に、キー割り当てがあればその機能を優先し、リストの選択を行いません。
  • Alt+1〜9 (キー割り当て無効)
    Alt+1〜9に、キー割り当てで機能が割り当てられても無視して、リストの候補選択を行います。
  • 1〜9 (リスト表示時,数字の挿入無効)
    リスト表示されている場合、数字キー単独入力で、候補を選択します。
各種ダイアログ

秀丸エディタで使用される各種ダイアログでも、単語補完を有効にするか設定します。

各種ダイアログでの単語補完

「ファイルタイプ別の設定」-「その他」-「単語補完」

その他-単語補完

単語補完の自動表示

  • 自動表示
    ONにすると、自動で候補を表示します。(待ち時間は「動作環境」で設定)

  • 表示方法
    候補リストの表示方法を設定します。

    • リスト
    • ツールチップ(標準)
    • ステータスバー

  • 「単語補間の動作環境」ボタンは、「動作環境」の「単語補完」を開きます。

単語補完の検索対象

補完用データの検索先を指定します。

  • 現在編集中のテキスト
    編集中のファイルから補完内容を検索します。

  • 辞書ファイル
    指定された辞書ファイルから、補完内容を検索します。ワイルドカードのアスタリクス"*"が使用できるので、"*.txt"とすれば、複数ファイルも対象にする事が可能ですが、余計なファイルを読み込む場合もあります。(補完辞書ファイル専用フォルダを用意すると良いかもしれません)

  • 「詳細」ボタンで、詳細設定が出来ます。

    単語補完の検索対象の詳細

    • 辞書ファイルの種類

      • フリーフォーマット は通常のテキスト文書を辞書にします。

      • 行単位 は専用の辞書ファイルで、1行毎に候補を記述しておきます。
        行単位の場合、コメントを記述できます。

        • ☑コメントあり

          チェックをオンにすると、行中に「//」があるとそれ以降をコメントとみなし候補対象にしません。 (Ver.8.92以降。Ver.8.98未満は行頭に「//」があってもコメントと認識しない)

      [補足]も参照してください。

    • 補完候補を検索するための「検索方法」

      • 大/小文字の区別

        区別しない
        大文字/小文字を区別しないで検索します。
        候補だけ区別(標準の設定)
        表示する候補のみ大/小文字を区別します。
        候補も入力も区別
        入力も候補も、大/小文字を区別して、検索します。

      • 優先順位
        候補を表示する順序を設定します。

        「カーソルから近い順」は検索対象が「現在編集中のテキスト」または「直前の秀丸エディタ」の場合のみ有効な設定です。

        カーソルから近い順(標準の設定)
        候補は、カーソル位置に近い順に表示します。
        アルファベット順
        候補は、アルファベット順に表示します。
        長い文字順
        候補が長い順に表示します
        辞書優先
        辞書の内容を先に表示します。それ以降は「カーソルから近い順」になります。

      • 単語の種類
        単語と認識する内容を設定します。

        一般的な単語(標準の設定)
        半角英字からはじまって、数字を含む単語
        ドットシンタックス
        "."で連結された「一般的な単語」をひとかたまりの単語として扱います。
        HTML/XML
        「<html>」とか「</body>」等、HTML/XML出使われている記法も、ひとかたまりの単語として扱います。
        カスタム
        単語の構成内容を自分で定義します。

      • 単語の途中も検索
        通常は先頭マッチのみですが、入力を「単語の途中」でもマッチさせる場合は、「ON」にする。

      • 候補が一つの場合は自動的に決定
        通常は、候補が一つでも候補の選択を行いますが、候補を表示しないでそのまま決定したい場合は、「ON」にする。

    • 追加の検索対象
      指定された辞書ファイルとは別に、候補の検索対象を指定できます。

      直前の秀丸エディタ
      直前までアクティブだった秀丸エディタも検索対象にする。
      強調表示の定義
      強調表示の内容を検索対象にする。正規表現で指定している定義は無視します。
      tagsファイル
      tagsファイルも対象にします。あらかじめtagsファイルを作成しておく必要があります。
      クリップボード
      現在のクリップボードの内容も対象にする。
      クリップボード履歴
      常駐秀丸があり、クリップボード履歴を使っている場合は、クリップボード履歴も対象にします。
      ファイル名
      カレントフォルダにあるファイルも対象にする。カレントがリムーバブルディスク、ネットワークドライブの場合は動作しません。

    また、「検索方法」にある「さらに」ボタンを押すと、「単語の種類」をカスタムにした場合の設定も可能です。

    単語補完の検索対象の詳細2

単語補完の類似検索

通常は、入力内容にマッチする候補のみ表示しますが、

☑「もしかして」の表示

をチェックしている場合は、マッチする候補がない場合は、入力内容に似た候補をリストアップします。 (入力をミスしていたり、あいまいな場合に有効です)

ただし、3文字以上の文字が入力されている必要があります。また、先頭文字が一致していないと、類似とみなしません。

  • 類似度合い
    どの程度まで合っている候補を表示するかを設定します。

    以下の設定から選択します。

    • 2/3(66%)
    • 3/4(75%)
    • 4/5(80%)

    66% では、最低の3文字の場合、2文字まで一致していれば、類似と判定します。

  • ミスの上限
    「類似度合い」で類似度合いを指定できますが、それとは別に類似判定(?)の上限を設定します。

    • 1〜4の値を選択します。

    正確にいうと、二つの文字列がどの程度異なっているかを示す「レーベンシュタイン距離」の上限になります。 (二つの文字列を同じにするに必要な、1文字の挿入・削除・置換作業の最小回数)

詳細については、 HMJRE.DLLのヘルプ-「類似検索の詳細」を参照してください。

[補足]

  • 補完用辞書ファイルは、Shift_JISで記述する必要があります。
    秀丸エディタ Ver.9.25より、UTF-8、UTF-16LE にも対応しました。

  • 「辞書ファイルの種類」ですが、「フリーフォーマット」だと特に指定はなく、通常の文書やテキストファイルから柔軟に補完対象を検索します。
    「行単位」の場合は、候補を1行毎に記述してください。マッチした場合は、1行まるごと候補として表示されます。 (マッチ自体は、先頭一致だけではなく、行内の途中にもマッチします)

    「辞書ファイルの種類」の設定による、補完動作の違いです。辞書ファイルの内容が以下のような場合、

    foundtopx, foundtopy, foundendx, foundendy

    「found」まで入力し、単語補完が動作した場合、以下のような違いがあります。

    • フリーフォーマットの場合
      各単語が個別に候補表示されます。(秀丸エディタ側が「検索方法」に従い、マッチした箇所を列挙する)

      単語補完-フリーフォーマット

    • 行単位の場合
      マッチした箇所を含む行全体が、候補表示されます。 (選択すると行の内容が挿入される)

      単語補完-行単位

  • 初期状態では、日本語は対象ではありませんが、設定を変更すれば対象にできます。ただ、IME(日本語入力ソフト)にも似たような機能があるので、日本語の場合はそちらを使った方が良いでしょう。

ページトップ　目次に戻る