Cette commande permet d’accéder à la boîte de dialogue Replace Text, à partir de laquelle vous pouvez configurer une recherche pour localiser et remplacer un texte spécifique dans le document en cours, dans tous les documents texte du projet actif, dans tous les documents texte ouverts ou dans tous les documents texte d’un répertoire spécifié.
Cette commande est également accessible à l’aide du raccourci clavier Ctrl+H.
Après avoir lancé la commande, la boîte de dialogue Replace Text apparaît. La boîte de dialogue fonctionne essentiellement selon deux modes, avec des fonctionnalités fournies par deux onglets :
- Replace Text - utilisez les options de cet onglet pour configurer le remplacement de texte dans le document en cours uniquement. Pour remplacer uniquement la première occurrence du texte correspondant, cliquez sur OK. Si l’option Prompt on replace était activée, le texte sera mis en surbrillance et une boîte de dialogue apparaîtra pour confirmer le remplacement. Cliquez sur Yes pour remplacer uniquement cette occurrence. Vous aurez la possibilité de remplacer toutes les occurrences correspondantes à partir de cette boîte de dialogue. Sinon, pour tout remplacer dès le départ, cliquez sur Replace All plutôt que sur OK. Là encore, toutes les occurrences correspondantes du texte recherché seront soit remplacées directement, soit remplacées après confirmation individuelle, selon l’état de l’option Prompt on replace.
- Replace in Files - utilisez les options de cet onglet pour configurer un remplacement de texte dans tous les documents texte du projet actif, dans tous les documents texte ouverts ou dans tous les documents texte d’un répertoire spécifié. Après avoir cliqué sur OK, toutes les occurrences du texte correspondant trouvées dans les fichiers inclus dans le périmètre de la recherche seront remplacées. Là encore, vous pouvez choisir d’être invité à confirmer chaque remplacement en activant au préalable l’option Prompt on replace. La boîte de dialogue Replacing apparaîtra pour afficher la progression du remplacement. Chaque remplacement effectué sera répertorié sous forme d’entrées dans le panneau Messages. Chaque message indiquera le fichier source, la ligne sur laquelle le texte recherché a été trouvé, le texte complet de cette ligne et la position du caractère dans cette ligne à laquelle commence la chaîne de texte recherchée.
Dans chaque cas, une boîte de dialogue d’information apparaîtra, résumant le nombre de remplacements effectués.
Conseils
- Chaque message dans le panneau Messages est de la forme (x, y): <OriginalLineText>, où x est la position du caractère sur la ligne y du document. Le texte affiché correspond au texte d’origine, avant remplacement.
- Les fichiers n’ont pas besoin d’être ouverts pour remplacer du texte à l’aide du mode Replace in Files. Ces fichiers peuvent éventuellement être ouverts après le remplacement en activant l’option Open changed files in editor avant d’effectuer le remplacement.
- Lors de l’utilisation du mode Replace in Files, il est possible d’effectuer un cross-probing vers le texte remplacé à partir de l’entrée du panneau Messages : il suffit de double-cliquer sur le message.
AI-localized