GBEPad : Les macros [ Retour menu général ] Les macros sous GBEPad GBEPad dispose en natif d'un grand nombre de fonctionnalités. Cependant, vous aurez peut être besoin d'une fonction spécifique de manipulation de chaine de caractères. Bonne nouvelle, vous pouvez développer votre propre macro en PHP et ainsi étendre les fonctionalités de GBEPad en fonction de vos besoins ! Pré-requis : GBEPad suppose que vous disposer de PHP installé et configuré sur votre machine. Ces outils sont gratuits et vous pouvez les trouver : http://www.php.net/downloads.php Vous devrez respecter les règles ci dessous dans l'écriture de vos macros. Ces règles sont nécessaires pour permettre à GBEPad de fournir les informations dynamiquement à la macro puis pour récupérer son résultat. Configuration Vous configurez l'usage des macros dans GBEPad via la boite de dialogue de configuration dans la rubrique Macros. Règles d'écriture d'une macro en PHP pour GBEPad Vous ne devez écrire que le corps de la macro. Au moment d'exécuter une macro, GBEPad va lire le source de cette macro et le compléter avec des informations fournies dynamiquement (par exemple le texte sélectionné, le nom du fichier à traiter, la position du curseur etc...). Le source de la macro réellement exécutée est alors généré dans le répertoire de GBEPad sous le nom GBEPadmacro.tmp. Dans les options de configuration des macros, si vous cochez la case "Supprimer les fichiers temporaires...", cela siginfie qu'à la fin de l'exécution de la macro le fichier GBEPadmacro.tmp sera automatiquement supprimé. Je vous conseille donc pendant la phase de mise au point de votre macro de décochez cette case. Cela vous permettra de voir le source réellement utilisé. GBEPad déclare automatiquement les variables suivantes pour fournir les informations à la macro PHP : $_SERVER["NomFichier"] : cette variable contient le chemin et le nom de fichier actif sous GBEPad. $_SERVER["FichierEnregistre"] : indique si le fichier a été enregistrer ou non sous GBEPad. $_SERVER["Texte"] : cette variable contient tout le contenu du fichier actif (elle est alimentée par la fonction PHP file_get_contents("Répertoire d'installation de GBEPad\GBEPadtxt.tmp"). GBEPad génère automatiquement le fichier GBEPadtxt.tmp avec le contenu complet du fichier actif. $_SERVER["TexteSelectionne"] : cette variable contient la chaine de caractères sélectionnée sous GBEPad (elle est alimentée par la fonction PHP file_get_contents("Répertoire d'installation de GBEPad\GBEPadsel.tmp"). GBEPad génère automatiquement le fichier GBEPadsel.tmp avec la selection active. $_SERVER["CurX"] : contient l'indice de la colonne active $_SERVER["CurY"] : contient l'indice de la ligne active $_SERVER["BlockX"] : contient l'absisse du coin supérieur gauche de la sélection $_SERVER["BlockY"] : contient l'ordonnée du coin supérieur gauche de la sélection $_SERVER["BlockX1"] : contient l'absisse du coin inférieur droit de la sélection $_SERVER["BlockY1"] : contient l'ordonnée du coin inférieur droit de la sélection Vous pouvez utilisez ces variables dans votre macro PHP pour récupérer ces informations. Ensuite, à la fin de chaque macro PHP vous devez avoir la ligne suivante : while (list($var, $value) = each($_SERVER)) print "$var=$value".chr(27); Cette ligne permet à GBEPad de récupérer le résultat de la macro. Enfin, vous pouvez utiliser la variable $_SERVER['Message'] pour que GBEPad provoque l'affichage d'un message fourni par la macro. Exemple : Le code suivant affihera un message si aucune sélection n'est active dans GBEPad : if (trim($_SERVER['TexteSelectionne'])=='') { $_SERVER['Message'] = 'Vous devez sélectionner une chaine de caractères.'; } Enfin, vous pouvez vous rendre sur mon site pour récupérer des macros déjà toutes prêtes. Pour aller plus loin Vous avez mis au point une macro et vous souhaitez en faire profiter la communauté des utilisateurs de GBEPad ? Vous êtes à la recherche d'une fonctionnalité spécifique ? Rendez vous sur mon site à la page dédiée aux macros de GBEPad. Copyright © 2004-2009 par GBESoft, Tous droits réservés.