
To polecenie służy do otwarcia okna dialogowego Replace Text, w którym można skonfigurować wyszukiwanie w celu znalezienia i zastąpienia określonego tekstu — znajdującego się w bieżącym dokumencie, we wszystkich dokumentach tekstowych w aktywnym projekcie, we wszystkich otwartych dokumentach tekstowych lub we wszystkich dokumentach tekstowych w określonym katalogu.
Do tego polecenia można również uzyskać dostęp za pomocą Ctrl+H skrótu klawiaturowego.
Po uruchomieniu polecenia pojawi się okno dialogowe Replace Text. Okno działa zasadniczo w dwóch trybach, a funkcjonalność jest dostępna dzięki dwóm kartom:
- Replace Text - użyj opcji na tej karcie, aby skonfigurować zastępowanie tekstu wyłącznie w bieżącym dokumencie. Aby zastąpić tylko pierwsze wystąpienie pasującego tekstu, kliknij OK. Jeśli opcja Prompt on replace była włączona, tekst zostanie podświetlony, a następnie pojawi się okno dialogowe z prośbą o potwierdzenie zamiany. Kliknij Yes , aby zastąpić tylko to wystąpienie. Z tego okna dialogowego będzie można również zastąpić wszystkie pasujące wystąpienia. Alternatywnie, aby od razu zastąpić wszystkie, kliknij Replace All zamiast OK. Ponownie, wszystkie pasujące wystąpienia wyszukiwanego tekstu zostaną zastąpione bezpośrednio albo z indywidualnym potwierdzaniem — w zależności od stanu opcji Prompt on replace.
- Replace in Files - użyj opcji na tej karcie, aby skonfigurować zastępowanie tekstu we wszystkich dokumentach tekstowych w aktywnym projekcie, we wszystkich otwartych dokumentach tekstowych lub we wszystkich dokumentach tekstowych w określonym katalogu. Po kliknięciu OK wszystkie wystąpienia pasującego tekstu znalezione w plikach objętych zakresem wyszukiwania zostaną zastąpione. Również tutaj możesz wybrać potwierdzanie zamiany, ustawiając wcześniej opcję Prompt on replace. Pojawi się okno dialogowe Replacing , pokazujące postęp zamiany. Każda wykonana zamiana zostanie wypisana jako wpis w panelu Messages. Każdy komunikat będzie zawierał plik źródłowy, wiersz, w którym znaleziono szukany tekst, cały tekst w tym wierszu oraz pozycję znaku w tym wierszu, od której zaczyna się wyszukiwany ciąg.
W każdym przypadku pojawi się okno dialogowe z informacją, podsumowujące liczbę wykonanych zamian.
Wskazówki
- Każdy komunikat w Messages panelu ma postać (x, y): <OriginalLineText>, gdzie x to pozycja znaku w wierszu y dokumentu. Tekst pokazuje oryginalny tekst sprzed zamiany.
- Pliki nie muszą być otwarte, aby zastępować tekst w trybie Replace in Files. Takie pliki można opcjonalnie otworzyć po zamianie, włączając wcześniej opcję Open changed files in editor, przed wykonaniem zamiany.
- Podczas korzystania z trybu Replace in Files można przejść (cross-probe) do zastąpionego tekstu z wpisu w Messages panelu — wystarczy dwukrotnie kliknąć komunikat.