このコマンドはReplace Textダイアログを開くために使用します。ここで、現在のドキュメント内、アクティブなプロジェクト内のすべてのテキストベースのドキュメント、開いているすべてのテキストベースのドキュメント、または指定したディレクトリ内のすべてのテキストベースのドキュメントにある特定のテキストを検索して置換する設定ができます。
このコマンドはCtrl+Hキーボードショートカットからも実行できます。
コマンドを起動すると、Replace Textダイアログが表示されます。このダイアログは基本的に2つのモードで動作し、2つのタブで機能が提供されます。
- Replace Text - このタブのオプションを使用して、現在のドキュメント内のみを対象にテキスト置換を設定します。一致テキストの最初の箇所だけを置換するには、OKをクリックします。Prompt on replaceオプションが有効な場合、テキストがハイライト表示され、置換を確認するダイアログが表示されます。Yes をクリックすると、この箇所のみを置換します。このダイアログから、すべての一致箇所を置換することもできます。あるいは、最初からすべてを置換するには、OKではなくReplace Allをクリックします。ここでも、検索テキストの一致箇所は、Prompt on replaceオプションの状態に応じて、直接置換されるか、または個別に確認しながら置換されます。
- Replace in Files - このタブのオプションを使用して、アクティブなプロジェクト内のすべてのテキストベースのドキュメント、開いているすべてのテキストベースのドキュメント、または指定したディレクトリ内のすべてのテキストベースのドキュメントを対象にテキスト置換を設定します。OKをクリックすると、検索範囲に含まれるファイルで見つかった一致箇所がすべて置換されます。ここでも、事前にPrompt on replaceオプションを設定しておくことで、置換時に確認を求めるようにできます。置換の進行状況を表示するためにReplacing ダイアログが表示されます。実行された各置換は、Messagesパネルにエントリとして一覧表示されます。各メッセージには、ソースファイル、検索テキストが見つかった行、その行の全文、そしてその行内で検索文字列が開始する文字位置が表示されます。
いずれの場合も、置換回数を要約した情報ダイアログが表示されます。
ヒント
- Messages パネル内の各メッセージは(x, y): <OriginalLineText>の形式で、xはドキュメントのy行目における文字位置を表します。表示されるテキストは、置換前の元のテキストです。
- Replace in Filesモードを使用したテキスト置換では、ファイルを開いている必要はありません。これらのファイルは、置換を実行する前にOpen changed files in editorオプションを有効にしておけば、置換後に任意で開くことができます。
- Replace in Filesモードを使用している場合、Messages パネルのエントリから置換されたテキストへクロスプローブできます。メッセージをダブルクリックするだけです。
AI で翻訳