Editeur de code

De Appmethod Topics
Aller à : navigation, rechercher

Remonter à Utilisation de l'éditeur de code et de l'EDI

L'éditeur de code et le Concepteur de fiches occupent 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.

Au fur et à mesure que vous concevez l'interface utilisateur de votre application, Appmethod 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, Appmethod génère automatiquement un code pour vous permettre de démarrer. Vous pouvez considérer le code généré automatiquement comme un prototype qu'il est possible d'examiner lors de la création du programme.

Le menu contextuel de l'éditeur de code décrit les commandes de menu contextuel de l'éditeur de code.

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 de l'éditeur > Couleur. Dans le menu déroulant Elément, sélectionnez Ligne modifiée, puis changez les couleurs de l'avant-plan et de l'arrière-plan.

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 du 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

Appmethod fournit un formateur de code source personnalisable. Lors de l'édition du code dans l'éditeur de code, vous pouvez appliquer la commande de menu contextuel Formater le source (ou la commande de menu Edition > Formater le source) pour formater le code source. Vous pouvez définir les options de formatage (l'indentation, les espaces, les sauts de lignes, la capitalisation et l'alignement) dans le groupe Formateur de la boîte de dialogue Options (Outils > Options > 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 afin que seul ce bloc soit formaté.

Remarque : Les pages Options de l'éditeur fournissent d'autres options de formatage du code dont Options du source, Couleur, Affichage, Affectations de touches et Audit de code. Voir Personnalisation de l’éditeur de code.

Audit de code

L'audit de code désigne un sous-ensemble de fonctionnalités intégrées à l'éditeur de code (comme des conseils sur le paramétrage de code, sur le code lui-même ou sur l'audit d'aide, la saisie semi-automatique pour achèvement de code, de classe ou de bloc) et destinées à aider l'utilisateur lors de l'écriture du code. Ces fonctionnalités facilitent l'identification d'instructions communes à 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 contextuelle affiche une liste de symboles valides à 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 Object Pascal, la fenêtre popup 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 supporte 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 contenant des noms d'argument et des types d'appel à 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 Object Pascal quand la fonctionnalité Audit d'aide est désactivée. Pour désactiver l'audit d'aide, annulez la sélection de Conseil d'audit d'aide de la boîte de dialogue Outils > Options > Options de l'éditeur > Audit de code.

Audit d'aide

Conseil d'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 invoquer l'audit d'aide en appuyant sur CTRL+MAJ+H.

Achèvement du code

La fonctionnalité Achèvement du code affiche une liste déroulante des symboles disponibles à l'emplacement du curseur. Pour invoquer l'achèvement du code :

  • Appuyez sur Ctrl+Espace (cette combinaison de touches invoque toujours l'achèvement de code).
  • Entrez . (cela 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 classe que vous déclarez. En positionnant le curseur n'importe où dans la déclaration de classe dans la section interface d'une unité et en appuyant sur Ctrl+Maj+C (ou en cliquant avec le bouton droit et en sélectionnant Compléter la classe au niveau du curseur dans le menu contextuel de l'éditeur de code), toutes les déclarations de propriété 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.

Vous pouvez aussi utiliser l'achèvement de classe pour remplir les déclarations interface pour les méthodes que vous définissez dans la section implementation :

Achèvement de bloc

Si vous appuyez sur Entrée depuis l'éditeur de code 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 Object Pascal et tapez le token begin puis appuyez sur Entrée, l'éditeur de code termine automatiquement l'instruction et vous obtenez le résultat ci-dessous : begin end.

Navigation dans le code (Ctrl+clic)

Lors de l'utilisation de l'éditeur de code pour modifier une application, comme une application Fiches FireMonkey, 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 tout en passant 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. La recherche s'effectue au sein des répertoires dans l'ordre suivant :

  1. Soit le chemin de recherche spécifique au projet pour Object Pascal (Projet > Options > Compilateur Object Pascal) ou le chemin d'inclusion pour C++ (Projet > Options > Répertoires et conditions).
  2. Le chemin de navigation global (pour Object Pascal : Outils > Options > Options d'environnement > Options Object Pascal > Bibliothèque ou pour C++ : Outils > Options > Options d'environnement > Options C++ > Chemins et répertoires).

Une alternative à l'utilisation de Ctrl+clic pour accéder à la déclaration d'un identificateur consiste à utiliser Alt+Haut (flèche). Pour consulter d'autres combinaisons de touches utiles, voir Raccourcis clavier par défaut.

Navigation dans le code

Les sections ci-dessous décrivent les fonctionnalités que vous pouvez utiliser pour 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 de plusieurs raccourcis. Vous pouvez aussi demander à ne naviguer qu'entre les 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 les 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 -- se déplace vers la méthode suivante.
  • Ctrl+Alt+Début -- première méthode du source.
  • Ctrl+Alt+Fin-- dernière méthode du source.
  • Ctrl+Alt+Roue_souris -- défile à travers 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 pour la sélection. Une fois votre choix effectué, l'EDI navigue jusqu'à sa déclaration.

Recherche d'unités

Si vous programmez en langage Object Pascal, 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.

Recherche des modifications précédentes et suivantes

Lors de l'édition du code, vous pouvez utiliser des combinaisons de touches pour naviguer rapidement vers les modifications précédentes et suivantes que vous avez effectuées. Les raccourcis clavier sont :

  • Ctrl+Maj+F7 -- déplace le curseur sur la modification précédente effectuée depuis l'ouverture du fichier (marque verte dans la gouttière).
  • Ctrl+Maj+F8 -- déplace le curseur sur la modification suivante effectuée depuis l'ouverture du fichier (marque verte dans la gouttière).
  • Alt+Maj+F7 -- déplace le curseur sur la modification précédente effectuée depuis la dernière sauvegarde (marque jaune dans la gouttière).
  • Alt+Maj+F8 -- déplace le curseur sur la modification suivante effectuée depuis la dernière sauvegarde (marque jaune dans la gouttière).

Si la ligne relative à la modification précédente ou suivante est un bloc élidé (plié), le bloc est déplié. Le pliage du code est décrit ci-après dans cette rubrique.

Les combinaisons de touches sont les mêmes pour les mappages clavier suivants : Défaut, EDI classique, Brief et Epsilon Les mappages clavier Visual Studio et Visual Basic ne disposent pas de combinaisons de touches pour les modifications précédentes / suivantes.

Recherche des utilisations dans le code source

Si vous programmez en langage Object Pascal, vous pouvez utiliser la fonctionnalité Rechercher les utilisations pour trouver les utilisations des classes, des méthodes, des variables, des méthodes de redéfinition, des classes dérivées et des interfaces implémentées dans vos projets de code source.

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 vous permet de réduire 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 réduit n'est pas supprimé, mais seulement masqué 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, cliquez sur 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 réduire 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.

Vous pouvez aussi utiliser la commande de menu contextuel Plier pour plier des types de régions spécifiques, tels que Types, Méthodes, Commentaires de documentation XML (pour Object Pascal) et la région 'Plus proche'. Les commandes Plier et Déplier sont décrites dans Menu contextuel de l'éditeur de code. 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

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

Lors de l'édition du code, vous pouvez enregistrer une série de séquences de touches sous forme de macro. Une fois enregistrée, la macro peut être exécutée pour répéter la séquence 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 Icône Signet s'affiche dans la gouttière gauche de l'éditeur de code. Dans un fichier, vous pouvez utiliser jusqu'à dix signets, numérotés de 0 Bookmark0.bmp à 9Bookmark9.bmp.

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