Achèvement de code

Remonter à Introduction à RAD Studio

L'achèvement du code (Ctrl+Espace) est une fonctionnalité Audit de code disponible dans l'éditeur de code. L'achèvement du code affiche une fenêtre de "conseil" redimensionnable qui liste les éléments que vous pouvez sélectionner pour les insérer dans votre code. Vous pouvez contrôler le tri des éléments dans la fenêtre de conseil de l'achèvement du code, en cliquant avec le bouton droit dans cette boîte et en choisissant Trier par nom ou Trier par portée.

Les éléments différents apparaissent dans la liste Achèvement du code sous des couleurs différentes. Par exemple, les procédures sont par défaut en marron, les fonctions en bleu sombre et les méthodes abstraites en rouge.

Invocation de l'achèvement du code

L'achèvement automatique du code est activé par défaut, et les options d'activation et de désactivation de l'achèvement du code sont situées sur la boîte de dialogue Outils > Options > Options de l'éditeur > Audit de code.

• Quand l'option Invoquer automatiquement est activée pour l'achèvement de code, taper un point (.) invoque l'achèvement de code pour Delphi et C++ (C++ supporte aussi ->). Si l'option Délai est définie, une minuterie est lancée avant l'invocation de l'achèvement du code.
• Toutefois, vous pouvez utiliser Ctrl+Espace pour invoquer l'achèvement du code dans Delphi et C++, même si l'option Invoquer automatiquement est désactivée.

Utilisation de l'achèvement du code

Voici diverses façons spécifiques d'utiliser l'achèvement du code dans l'EDI :

• Pour afficher les propriétés, les méthodes et les événements disponibles dans une classe, appuyez sur Ctrl+Espace après le nom d'une variable qui représente une instance de classe ou un pointeur à une instance de classe.
• Pour invoquer l'achèvement du code pour un type pointeur, le pointeur doit d'abord être déréférencé.

Par exemple, dans Delphi, tapez : self.

Dans C++, tapez : this->

• Tapez une flèche (->) pour un pointeur vers un objet.
• Vous pouvez également taper le nom des types non-pointeur suivi d'un point (.) afin de voir la liste des propriétés, méthodes et événements, hérités et virtuels.
• Par exemple, dans C++, tapez : TRect test;test.

Dans Delphi, tapez : var test: TRect; begin test.

• Tapez un opérateur d'affectation ou le début d'une instruction d'affectation et appuyez sur Ctrl+Espace pour afficher la liste des valeurs possibles pour la variable.
• Dans C++, tapez l'opérateur de portée (::).
• Tapez un appel de procédure, de fonction ou de méthode et appuyez sur Ctrl+Espace pour afficher la liste des arguments valides pour affectation à la variable entrée. Sélectionnez un élément de la liste suivi de points de suspension (...) pour ouvrir une seconde liste d'arguments compatibles avec la variable entrée dans l'instruction d'affectation.
• Tapez un enregistrement (Delphi) ou une structure (C++) pour afficher une liste de champs.
• Tapez une propriété tableau (et non un véritable tableau) et appuyez sur Ctrl+Espace pour afficher une expression d'index.
• Dans C++, vous pouvez également appuyer sur Ctrl+Espace sur une ligne d'instruction vide pour afficher les symboles provenant d'unités RTL supplémentaires même s'ils ne sont pas utilisés par l'unité en cours.
• Dans Delphi, les mots réservés apparaissent dans la fenêtre Achèvement du code si vous avez activé Afficher les mots réservés sur la boîte de dialogue Outils > Options > Options de l'éditeur > Audit de code. Les mots qui apparaissent sont déterminés par le contexte quand vous invoquez Achèvement du code. La liste en cours des mots réservés de Delphi est disponible dans le Guide du langage Delphi (Eléments syntaxiques fondamentaux).

Annulation de l'achèvement du code ou Disparition de la fenêtre Achèvement du code

Quand vous invoquez l'achèvement du code, le curseur devient un sablier indiquant que l'EDI traite votre requête.

• Pour annuler une requête d'achèvement de code avant qu'elle ne se termine, appuyez sur la touche Echap.
• Pour faire disparaître la fenêtre Achèvement du code, appuyez sur la touche Echap (ou cliquez simplement n'importe où ailleurs).

Navigation vers une déclaration

Quand la fenêtre Achèvement du code est affichée, vous pouvez maintenir enfoncée la touche Ctrl et cliquer sur un identificateur de la liste pour atteindre sa déclaration.

Ainsi, si vous faites passer le pointeur de la souris au-dessus d'un identificateur dans l'éditeur de code, une fenêtre de conseil indique où l'identificateur est déclaré. Vous pouvez appuyer sur Ctrl, pointer sur l'identificateur dans le code (il passe en souligné bleu, par défaut, et le point d'insertion prend la forme d'une main), puis cliquer (avec la souris) pour aller sur sa déclaration.

Remarque : L'audit de code fonctionne uniquement dans l'unité de compilation. L'achèvement du 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.

Remarque : Pour C++, les caractéristiques d'achèvement du code fonctionnent mieux si vous avez déjà construit votre application et créé un en-tête précompilé. Sinon, vous devez attendre que le compilateur génère l'information requise. Il est recommandé de cocher l'option Utiliser les en-têtes précompilés sur la boîte de dialogue Projet > Options > Compilateur.

Voir aussi

• Editeur de code
• Utilisation de l'audit de code