Extending the IDE/fr

From Free Pascal wiki
Jump to navigationJump to search

Deutsch (de) English (en) español (es) français (fr) 日本語 (ja) русский (ru) slovenčina (sk) 中文(中国大陆) (zh_CN)

Étendre l'IDE

Vue d'ensemble

L'IDE supporte plusieurs types de plugins :

Composants
Ce sont les éléments de la palette des composants. Par exemple, TButton peut être employé pour créer des boutons.
Éditeurs de composants
Les éditeurs de composants sont employés quand on double-clique sur un composant dans le concepteur. Ils peuvent aussi servir à ajouter un élément au menu surgissant du concepteur quand on clique sur un composant avec le bouton droit de la souris.
Éditeurs de propriétés
Ceux-ci sont utilisés par chaque ligne de l'inspecteur d'objet afin de pouvoir établir ou modifier la valeur d'une propriété du composant sélectionné.
Experts
Ceux-ci représentent tous les autres types. Ils comprennent les nouveaux éléments d'un menu, les combinaisons de touches pour les raccourcis, ou encore de nouvelles fonctionnalités pour l'IDE.


Il y a deux possibilités pour ajouter vos propres plugins à Lazarus :

  1. écrire un paquet, l'installer et enregistrer les plugins dans la procédure «register» d'une unité ;
  2. étendre le code de Lazarus, et envoyer le fichier diff CVS(Concurrent Versions System) à la liste de courriel de Lazarus.

Écrire des Composants

ToDo Conseil: Créer un nouveau composant par l'intermédiaire de l'éditeur de paquet.

Écrire un éditeurs de composant

ToDo Conseil: voir le fichier componenteditors.pas pour des exemples

Écrire un éditeurs de propriété

ToDo Conseil: voir le fichier propedits.pp pour des exemples

Traiter les registres d'événement

Il y a plusieurs événements dans l'IDE, pour quelles plugins peuvent ajouter leurs propres traitement. Dans propedits.pp il y a un objet "GlobalDesignHook", qui maintient plusieurs évènements de conception. Chaque événement appelle une liste de traitement. Les traitements par défaut sont ajoutés par l'IDE. Vous pouvez ajouter vos propres traitements avec les méthodes AddHandlerXXX et RemoveHandlerXXX. Ils s'appelleront avant les traitements par défaut.

Exemples :

 Ajoutez votre traitement (ceci est normalement fait dans le constructeur de votre objet):
   GlobalDesignHook.AddHandlerComponentAdded(@YourOnComponentAdded);
Enlevez votre traitement : GlobalDesignHook.RemoveHandlerComponentAdded(@YourOnComponentAdded);
Vous pouvez enlever tous les traitements immédiatement. Par exemple, c'est une bonne idée d'ajouter cette ligne dans le destructeur de l'objet : GlobalDesignHook.RemoveAllHandlersForObject(Self);

Les traitements de GlobalDesignHook :

 // racine de consultation 
 ChangeLookupRoot
   Appelé quand le "LookupRoot" a changé. 
   Le "LookupRoot" est l'objet du propriétaire des composants actuellement choisis. 
   Normalement c'est un TForm. 
// méthodes CreateMethod GetMethodName GetMethods MethodExists RenameMethod ShowMethod Called MethodFromAncestor ChainCall
// composants GetComponent GetComponentName GetComponentNames GetRootClassName ComponentRenamed Appelé quand un composant a été renommé. ComponentAdded Appelé quand un nouveau composant a été ajouté au LookupRoot ComponentDeleting Appelé avant qu'un composant soit libéré. DeleteComponent Appelé par l'IDE pour supprimer un composant. GetSelectedComponents Obtenir le choix courant des composants.
// objets persistants GetObject GetObjectName GetObjectNames
// modifing Modified Revert RefreshPropertyValues

Ajouter de l'aide pour des sources

Créer d'abord un THelpDatabase :

 HelpDB:=TFPDocHTMLHelpDatabase(
    HelpDatabases.CreateHelpDatabase('ANameOfYourChoiceForTheDatabase',
                                            TFPDocHTMLHelpDatabase,true));
 HelpDB.DefaultBaseURL:='http://your.help.org/';
 FPDocNode:=THelpNode.CreateURL(HelpDB,
                  'Package1 - A new package',
                  'file://index.html');
 HelpDB.TOCNode:=THelpNode.Create(HelpDB,FPDocNode);// once as TOC
 DirectoryItem:=THelpDBISourceDirectory.Create(FPDocNode,'$(PkgDir)/lcl',
                                 '*.pp;*.pas',false);// and once as normal page
 HelpDB.RegisterItem(DirectoryItem);