![]() |
|
4DPop installe une palette dans le mode développement. Cette palette s'enrichit d'outils au fur et à mesure de l'installation de composants compatibles.
1. | Créez un dossier "Components" à côté du fichier de structure de votre base (".4db") |
2. | Placer le dossier "4DPop.4dbase"* ou un alias de ce dernier dans le dossier "Components" |
3. | Ouvrez votre base. |
4. | Dans la méthode base "Sur ouverture", tapez "Install 4DPop" puis la touche tabulation. Le code ci-essous est inséré dans la méthode.
`Run 4DPop |
5. | Redémarrez votre base, la palette s'affiche lorsque vous êtes en mode développement en bas à gauche de l'écran. |
*Sur Macintosh le composant est un package dont l'extension ".4dbase" n'est pas obligatoirement visible en fonction des réglages de vos préférences d'affichage.
L'aide de 4DPop est disponible dans le menu "Aide" ou en cliquant sur l'icône "i" de la palette.
Si la palette est présentée fermée, vous pouvez l'ouvrir en tirant sur la poignée.
Si vous double-cliquez sur la poignée de la palette fermée, celle-ci se déploie en ajustant sa taille au nombres d'outils présent. Un double clic sur la poignée de la palette ouverte la referme. La position de la palette et son état contracté ou déployé sont mémorisés entre chaque cession.
Si aucun composant compatible n’est installé, la palette déployée affiche une image
Si un ou plusieurs composants compatibles sont installés, ils apparaissent sous la forme de boutons.
Vous pouvez déplacer la palette par sa barre de titre, la placer à droite ou à gauche de l'écran. La position de la palette est mémorisée.
Un menu contextuel est accessible sur la barre de titre de la palette. Il reprend l'ensemble des outils chargés et des options d'affichage de la palette.
Vous pouvez installer un nouveau composant compatible dans la palette en le déposant sur cette dernière. Après confirmation un alias de la base est créé dans le dossier "Components" et la base redémarrée.
Si un ou plusieurs composants compatibles sont déposé sur la palette de 4DPop, cela provoque l'affichage d'un assistant d'installation qui permet de choisir entre une copie du composant dans le dossier "Components" ou la simple création d'un alias.
L'assistant permet en outre de redémarrer automatiquement la base lorsque l'installation est terminée afin que les nouveaux composants soient chargés.
Note : Les composants sont chargés par ordre alphabétique : Pour forcer un composant à être chargé en premier (le plus à gauche) vous pouvez préfixer le nom du dossier avec "01" par exemple.
Un clic contextuel sur la barre de titre de la palette déploie un menu reprenant :
Les outils que vous pouvez intégrer à 4DPop sont des composants interprétés ou compilés, ils répondent donc aux règles de développement des composants (cf. documentation).
L'intégration d'un composant dans la palette 4DPop est basée sur la présence d'un fichier « 4DPop.xml » dans le dossier « Resources » de la base du composant. Ce fichier décrit les éléments du composant qui seront disponibles à l'aide de clefs et de leurs attributs.
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> |
Balise | Description |
<tools></tools> | Début et fin du fichier (balises obligatoires)
Attributs : |
<tool></tool> | Début et fin d’une définition d’un outil et de ses attributs.
Cette balise peut être répétée : s’il n’y a qu’une balise <tool> la méthode est exécutée dès le clic sur le bouton, s’il y a plusieurs balises <tool> une flèche de menu liée au bouton est affichée et un menu listant les outils est proposé à l’utilisateur. Dans le cas où la balise default ci-dessus est définie, un clic simple lance la méthode définie par défaut et un clic long ou sur la flèche affiche le menu des outils. Attributs : Note : La méthode du composant peut se charger de construire et d'afficher le menu. Dans ce cas une seule balise <tool> appelle la méthode du composant dont le code affiche le menu et traite le choix de l'utilisateur. Pour que la flèche du menu lié soit affichée sur le bouton de votre outil, vous devez passer "true" dans l'attribut popup de la balise <tools> |
* Accepte la syntaxe « :xliff :resname » les chaînes doivent alors se trouver dans les fichiers xliff du composant. Cette syntaxe permet d'afficher une chaîne localisée.
** Les méthodes doivent avoir été déclarées comme partagées dans la base du composant.
Note : Toutes ces méthodes reçoivent en paramètre un pointeur (sur le bouton de la palette qui peut servir à tester l'état du bouton ou à positionner correctement un popup). Pour pouvoir faire fonctionner le composant en compilé, ce paramètre doit être déclaré explicitement [C_POINTEUR($1)] dans toutes les méthodes du composant appelées par 4DPop (initproc, ondrop, default, et method) sinon une erreur (-20008 - Paramètres incorrects dans une commande EXECUTER) sera générée à chaque fois que la méthode est appelée.
version 1.2 :
- La version du composant est affichée dans le coin supérieur gauche de la palette.
- La palette de 4DPop se souvient de son état déployé/contracté entre deux sessions.
- Implémentation d'un assistant d'installation.
- Possibilité d'installer plusieurs composants simultanément.
- Il est maintenant possible de changer l'aspect de la palette.
- Ajout de la balise ondrop.
Ce composant est fourni en version compilée, mais vous trouverez le code source dans le dossier "Sources" à l'intérieur du dossier du composant.
Un forum pour 4DPop est disponible à cette adresse : Forum 4DPop