IDE directives/fr

From Free Pascal wiki

English (en) français (fr)

Généralités

Les directives de l'EDI sont similaires aux directives du compilateur : une forme spéciale de commentaires placées dans votre code source. Elles sont délimitées par des parenthèses avec un signe % devant. Par exemple :

{%H-}

Le compilateur les voit comme des commentaires qu'il ignore. L'EDI utilise ces directives pour stocker de l'information spécifique au source quii est indépendante du projet et de la session.

Masquer un conseil, une note ou un avertissement

Pour masquer un simple un conseil, une note ou un avertissement, vous utilisez la directive IDE suivante :

procedure DoSomething({%H-}NotUsed: char);
begin

end;

Ceci supprimera la ligne de conseil dans la fenêtre de messages de Lazarus qui rapporterait autrement :

Conseil: Le paramètre "NotUsed" n'est pas utilisé

Le compilateur délivre toujours le conseil, mais la directive EDI {%H-} fait filtrer le conseil dans la fenêtre de messages.

{Note : Vous pouvez cliquer avec le bouton droit dans la fenêtre de message et choisir de l'option de menu "Cacher le message via une directive" pour insérer la directive automatiquement.}

Cette fonctionnalités a été introduite dans Lazarus 0.9.29.

Encodage de fichier

Vous pouvez spécifier quel encodage l'EDI soit utiliser pour un fichier source en ajoutant un BOM (Byte Order Mark) ou une directive d'encodage au tout début du fichier source :

{%encoding CP1250}

Voir dans l'unité lcl/lconvencoding.pas quelles sont toutes les valeurs d'encodage possibles.

Fichier Exécuter/Construire

  • {%BuildCommand ...}
  • {%BuildWorkingDir ...}
  • {%BuildScan ...}
  • {%RunCommand ...}
  • {%RunWorkingDir ...}
  • {%RunFlags ...}

Voir Configurer le fichier de construction.

Autres directives EDI

  • {%Region} vous permet de définir vos propres blocs de pliage de code, en posant des commentaires dans le code. Vous devez spécifier la fin de la région avec {%Endregion}.
  • {%MainUnit path/to/unit.pas} Utilisé en première ligne dans un fichier d'inclusion pour donner aux outils de code une indication où se trouve le fichier d'unité. Tous les / et \ sont convertis dans le délimiteur de chemin courant.

Lecture/Recherche des directives EDI

L'unité d'outils de code basiccodetools contient plusieurs fonctions pour la lecture des directives EDI :

  • FindNextIDEDirective
  • CodeToolBoss.GetIDEDirectives