|
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 affichera 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 ? Rendez vous sur mon site à la page dédiée aux macros de GBEPad. |