Editeur de code

Remonter à Introduction à RAD Studio

L'éditeur de code occupe le volet central de la fenêtre de l'EDI. L'éditeur de code est un éditeur UTF8 complet et personnalisable qui comprend la mise en évidence syntaxique, de multiples capacités d'annulation et une aide contextuelle sur les éléments du langage.

A mesure que vous construisez l'interface utilisateur de votre application, RAD Studio génère le code sous-jacent. Lorsque vous modifiez les propriétés des objets, ces modifications sont automatiquement répercutées dans les fichiers source.

Comme tous vos programmes partagent des caractéristiques communes, RAD Studio génère automatiquement un code pour vous permettre de démarrer. Vous pouvez vous représenter le code généré automatiquement comme un cadre que vous pouvez examiner pour créer votre programme.

Les commandes du menu contextuel de l'éditeur de code sont décrites dans Menu contextuel de l'éditeur de code.

La Vidéo : Editeur RAD Studio 2010, par Mike Rozlog propose de bons conseils et astuces.

Pour vous assister dans l'écriture du code, l'éditeur de code fournit les fonctionnalités décrites dans cette section :

Barres de modification

La marge gauche de l'éditeur de code affiche une barre de modification verte pour indiquer les lignes qui n'ont pas été modifiées dans la session d'édition en cours. Une barre de modification jaune indique que des modifications ont été effectuées depuis la dernière opération Fichier > Enregistrer.

Toutefois, vous pouvez personnaliser les barres de modification afin qu'elles soient affichées dans des couleurs autres que les couleurs par défaut (jaune et vert). Sélectionnez Outils > Options > Options d'environnement > Options de l'éditeur.

Indentation du code

Vous pouvez utiliser la touche Tab pour indenter la ligne de code en cours ou un bloc de code dans l'éditeur de code. Le nombre d'espaces que la touche Tab indente est déterminé par l'option Indentation de bloc de la boîte de dialogue Outils > Options > Options de l'éditeur > Options du source.

Pour indenter une ligne de code, placez le curseur au début de la ligne et appuyez sur Tab.
Pour indenter un bloc de code entier, mettez en surbrillance le bloc de code et appuyez sur Tab.
Pour déplacer le texte vers la gauche ("indentation négative"), utilisez Maj + Tab.

Formatage du code

Lors de l'édition du code Delphi ou C++ dans l'éditeur de code, vous pouvez appliquer la commande de menu contextuel Formater le source pour formater le code source. Vous pouvez définir les options du formateur pour les groupes Indentation, Espaces, Sauts de ligne et Capitalisation de la boîte de dialogue Options (Outils > Options) sous le groupe Formateur. Sachez que la commande Formater le source implémente le formatage automatique de votre code. Elle ne prend en compte que les options de formatage spécifiées dans la boîte de dialogue Options et redéfinit complètement l'ensemble du formatage manuel implémenté dans l'éditeur de code. Par exemple, elle ignore votre indentation manuelle de code. Vous pouvez sélectionner un bloc de code et appeler la commande Formater le source. Seul ce bloc sera alors formaté.

Le formateur de code source est utilisé pour obtenir une meilleure présentation du code source. L'analyse du flux du programme, la recherche des bogues et la présentation du code est utile. Après de nombreuses modifications durant la correction itérative des bogues, le code source initial a généralement un aspect très étrange. Chaque méthode ou bloc est formaté avec son propre style et un mélange de tabulations et d'espaces pour l'indentation. Des paramètres différents de la taille des tabulations, utilisés par les auteurs, conduit au fait, qu'au lieu de fournir une explication claire de la structure des programmes, l'indentation ne fait qu'embrouiller l'utilisateur. Un formatage du source correct peut vous aider à chercher les bogues plus rapidement, et à comprendre la logique du programme.

Audit de code

L'audit de code désigne un ensemble de fonctionnalités intégrées à l'éditeur de code (par exemple, donnant des conseils sur le paramétrage de code, le code lui-même, ou relatives à l'audit d'aide, à la saisie semi-automatique pour achèvement de code, de classe ou de bloc) et accélérant l'écriture de code. Ces fonctionnalités facilitent l'identification d'instructions courantes à insérer dans votre code et vous aident à sélectionner des propriétés et des méthodes. Certaines de ces fonctionnalités sont décrites plus en détail dans les sous-sections suivantes.

Pour invoquer l'audit de code, appuyez sur Ctrl+Espace dans l'éditeur de code. Une fenêtre surgissante affiche une liste de symboles reconnus à l'emplacement du curseur.

Pour activer et configurer les fonctionnalités de l'audit de code, choisissez Outils > Options > Options de l'éditeur et cliquez sur Audit de code.

Si vous utilisez le langage Delphi, la fenêtre déroulante filtre toutes les déclarations de méthode d'interface référencées par les clauses de lecture ou d'écriture des propriétés. La fenêtre n'affiche que les propriétés et les méthodes autonomes déclarées dans le type interface. L'audit de code prend en charge les méthodes de messages WM_xxx, CM_xxx et CN_xxx comme les constantes nommées provenant de toutes les unités de la clause uses.

Conseils de paramétrage de code

Affiche un conseil proposant des noms d'arguments et des types d'appels à des méthodes. Disponible entre les parenthèses d'un appel, par exemple ShowMessage ( | ) ;

Pour obtenir des conseils sur le paramétrage de code, appuyez sur Ctrl+Maj+Espace.

Conseils de code

Affiche des informations sur le symbole telles que le type, le fichier et le numéro de ligne où il est déclaré.

Pour afficher des conseils sur le code lorsque vous travaillez dans l'éditeur de code, vous pouvez vous déplacer avec la souris au-dessus d'un identificateur.

Remarque : Les conseils de code fonctionnent seulement pour Delphi quand avez désactivé la fonctionnalité Audit d'aide. Pour désactiver l'audit d'aide, décochez la case Conseil d'audit d'aide de la boîte de dialogue Outils > Options > Options de l'éditeur > Audit de code.

Audit d'aide

Affiche des informations sur le symbole telles que le type, le fichier et le numéro de ligne où il est déclaré, ainsi que la documentation XML associée au symbole (s'il y a lieu).

Pour afficher des conseils sur l'aide lorsque vous travaillez dans l'éditeur de code, vous pouvez vous déplacer avec la souris au-dessus d'un identificateur. Vous pouvez aussi obtenir un audit de l'aide avec les touches Ctrl+Maj+H.

Achèvement de code

La fonctionnalité Achèvement de code affiche une liste des symboles disponibles à l'emplacement du curseur Pour invoquer la fonctionnalité dans le cadre de votre langage spécifique, utilisez la méthode suivante :

Dans Delphi :
- Appuyez sur Ctrl+Espace (invoque toujours l'achèvement de code).
- Entrez . (fonctionne seulement quand l'option Invoquer automatiquement est activée sur la page Audit de code).

Dans C++ :
- Appuyez sur Ctrl+Espace (invoque toujours l'achèvement de code).
- Entrez . ou -> (fonctionne seulement quand l'option Invoquer automatiquement est activée sur la page Audit de code).

Pour annuler une requête d'achèvement de code, appuyez sur la touche Echap.

Achèvement de classe

L'achèvement de classe simplifie le processus de définition et d'implémentation des nouvelles classes en générant le code squelette pour les membres de classes que vous déclarez. En positionnant le curseur n'importe où dans la déclaration d'une classe dans la section interface d'une unité et en appuyant sur CTRL+MAJ+C, toutes les déclarations de propriétés inachevées sont complétées. Pour toutes les méthodes nécessitant une implémentation, des méthodes vides sont ajoutées à la section implementation. L'achèvement de classe est aussi une commande ("Compléter la classe au niveau du curseur") du menu contextuel de l'éditeur de code.

Achèvement de bloc

Si, alors que vous vous trouvez dans l'éditeur de code, vous appuyez sur ENTREE sans fermer correctement un bloc de code, l'éditeur de code ajoute le token de fermeture du bloc sur la première ligne vide disponible après la position du curseur. Par exemple, si vous utilisez l'éditeur de code avec le langage Delphi et tapez le token begin puis appuyez sur ENTREE, l'éditeur de code termine automatiquement l'instruction et vous obtenez le résultat ci-dessous : begin end. Cette caractéristique fonctionne aussi pour le langage C++.

Navigation dans le code (Ctrl-clic)

Lors de l'utilisation de l'éditeur de code pour modifier une application, comme une application Fiches VCL, vous pouvez utiliser CTRL-clic pour "sauter" automatiquement sur le code qui définit un identificateur. Pour naviguer dans le code, maintenez enfoncée la touche CTRL pendant que vous passez la souris au-dessus du nom d'une classe, variable, propriété, méthode ou d'un autre identificateur. Quand le pointeur de la souris prend la forme d'une main et que l'identificateur est mis en surbrillance et souligné, cliquez sur l'identificateur en surbrillance, et l'éditeur de code saute sur la déclaration de l'identificateur et, si nécessaire, ouvre le fichier source.

Vous pouvez faire la même chose en cliquant avec le bouton droit sur un identificateur et en choisissant Chercher la déclaration dans le menu contextuel.

Le navigateur de code peut trouver et ouvrir uniquement les unités qui existent dans le chemin de recherche du projet ou dans le chemin de navigation global. Les répertoires sont recherchés dans l'ordre suivant :

Le chemin de recherche spécifique au projet pour Delphi (Projet > Options > Compilateur Delphi) ou le chemin d'inclusion pour C++ (Projet > Options > Répertoires et Conditions).
Le chemin de navigation global (pour Delphi : Outils > Options > Options d'environnement > Options Delphi > Bibliothèque - Win32, ou pour C++ : Outils > Options > Options d'environnement > Options C++ > Chemins et répertoires).

Navigation dans le code

Les sections ci-dessous décrivent les fonctionnalités avec lesquelles vous pouvez naviguer dans votre code tout en utilisant l'éditeur de code.

Navigation entre méthodes

Pour aller d'une méthode à une autre, vous disposez dans l'éditeur de plusieurs raccourcis. Vous pouvez aussi demander à ne naviguer qu'entre des méthodes de la classe en cours. Par exemple, si vous avez activé le verrouillage de classe alors que vous vous trouvez dans une méthode de TComponent, vous ne pouvez vous déplacer qu'entre méthodes de TComponent.

Voici les raccourcis clavier de la navigation entre méthodes :

CTRL+Q^L - active/désactive le verrouillage de classe.
CTRL+ALT+HAUT - se déplace vers le haut de la méthode en cours ou vers la méthode précédente.
CTRL+ALT+BAS - va à la méthode suivante.
CTRL+ALT+DEBUT - première méthode du source.
CTRL+ALT+FIN - dernière méthode du source.
CTRL+ALT+DEPLACEMENT_SOURIS - défile dans les méthodes.

Recherche de classes

Vous permet de rechercher des classes. Utilisez la commande Chercher > Rechercher une classe pour obtenir la liste des classes disponibles dans laquelle vous pouvez effectuer une sélection. Une fois votre choix effectué, l'EDI navigue jusqu'à sa déclaration.

Recherche d'unités

Si vous programmez en langage Delphi, vous pouvez utiliser une fonction de refactoring pour localiser les espaces de nommage ou les unités. Utilisez la commande Rechercher une unité pour localiser et ajouter des unités à votre fichier de code.

Templates dynamiques

Les templates dynamiques mettent à votre disposition un dictionnaire de code pré-écrit, que vous pouvez insérer dans vos programmes tout en utilisant l'éditeur de code. Vous réduisez ainsi la frappe au clavier que vous devez effectuer.

Utilisez les liens proposés à la fin de cette rubrique pour en savoir plus sur la création et l'utilisation de templates dynamiques.

Pliage du code

Le pliage du code permet de replier ou de développer des régions ou des blocs de code. Le pliage de votre code crée une vue hiérarchique du code facile à lire et à parcourir. Le code replié n'est pas supprimé, mais seulement caché de la vue jusqu'à ce que vous le développiez. Le pliage du code est activé par défaut.

Pour utiliser le pliage du code, utilisez les signes plus (+) et moins (-) situés sur le bord gauche de l'éditeur de code :

Cliquez sur le signe plus (+) pour développer la région de code associée.
Cliquez sur le signe moins (-) pour replier la région de code associée.

Pour activer/désactiver le pliage du code :

Utilisez la case à cocher Pliage du code de la boîte de dialogue Outils > Options > Options de l'éditeur.
Utilisez le raccourci clavier Ctrl+Maj K+O.

Pour de plus amples informations sur le pliage du code, y compris comment créer des régions de pliage de code, voir Utilisation du pliage de code.

Refactoring

Le refactoring est le processus d'amélioration de votre code sans changer sa fonctionnalité externe. Par exemple, vous pouvez transformer un fragment de code sélectionné en méthode au moyen du refactoring d'extraction de méthode. L'EDI déplace le code extrait hors de la méthode en cours, détermine les paramètres nécessaires, génère des variables locales si nécessaire, détermine le type de retour et remplace le fragment de code par un appel à la nouvelle méthode. D'autres refactorings sont disponibles, par exemple le renommage d'un symbole et la déclaration d'une variable.

Synchronisation des modifications

Nouvelle vidéo 2010 ! Vidéo : Syncronisation des modifications dans RAD Studio 2010, par Mike Rozlog

La fonctionnalité de synchronisation des modifications vous permet de modifier simultanément des identificateurs identiques dans le code. Quand vous modifiez le premier identificateur, la même modification est automatiquement appliquée aux autres identificateurs. Vous pouvez aussi définir des points de saut pour naviguer jusqu'aux sections spécifiques de votre code.

Listes A faire

Une liste A faire enregistre les tâches d'un projet devant être achevées. Après avoir ajouté une tâche à la liste A faire, vous pouvez la modifier, l'ajouter à votre code en tant que commentaire, indiquer qu'elle est achevée et la supprimer de la liste. Vous pouvez filtrer la liste pour n'afficher que les tâches qui vous intéressent.

Macros clavier

Vous pouvez enregistrer une série de séquences de touches sous forme de macro lors de l'édition du code. Une fois enregistrée, la macro peut être réutilisée pour répéter des séquences de touches lors de la session de l'EDI en cours. L'enregistrement d'une macro remplace la macro précédemment enregistrée.

Signets

Les signets fournissent un moyen pratique de naviguer dans les longs fichiers. Vous pouvez marquer un emplacement dans votre code avec un signet et accéder à cet emplacement depuis n'importe endroit au sein du fichier.

Lorsque vous définissez un signet, une icône de signet s'affiche dans la gouttière de gauche de l'éditeur de code. Vous pouvez utiliser jusqu'à dix signets, numérotés de 0 à 9 , au sein d'un fichier.

Vous pouvez effectuer l'opération glisser-déposer sur les icônes de signet dans la gouttière de l'éditeur de code ; un signet déplacé conserve le numéro du signet original.

Commentaires de bloc

Vous pouvez définir en commentaire une section de code en sélectionnant le code dans l'éditeur de code , puis en appuyant sur Ctrl+/ (barre oblique). Chaque ligne du code sélectionné comporte le préfixe // et est ignorée par le compilateur. L'appui sur Ctrl+/ ajoute ou retire les barres obliques, en fonction de la présence du préfixe // sur la première ligne du code. Si vous utilisez les mappages de touches Visual Studio ou Visual Basic, utilisez Ctrl+K+C pour ajouter ou retirer des barres obliques de commentaires.

Voir aussi