Cette fonction permet de récupérer la section correspondant à l'élément courant de la liste définie par la section donnée en paramètre ; il s'agit du dernier élément manipulé par une des fonctions de récupération d'élément de section de liste :
En effet, les fonctions
PgExToolNewItemSection,
PgExToolReadValue,
PgExToolWriteValue,
n'influent pas sur la gestion de l'élément courant de la liste.
Remarque importante : la dll PgExTool doit être chargée (ordre CHARGER_DLL) en début de programme et doit rester chargée au moment de l'appel des fonctions de gestion de listes de sections.
Paramètres
ALPHA(256) |
Fichier |
Nom complet du fichier de données. |
ALPHA(n) |
SectionListe |
Section liste. |
ALPHA(n) |
SectionElt |
Section élément de liste (mis à jour par la fonction) de type SectionListe#numéro ; il faut donc prévoir SectionElt plus grand que ce que contient SectionListe . |
NUM_BIN_4 |
TailleSection |
Taille de SectionElt : n. |
NUM_BIN_4 |
CodeRetour |
Code retour de lecture (mis à jour par la fonction). |
Valeurs possibles du code retour
0 |
Lecture réussie : SectionElt est alors renseignée et contient une section qui peut être utilisée dans les fonctions PgExToolReadValue et PgExToolWriteValue. |
Echec lors de la récupération de l'élément de la liste : SectionElt est retournée à blanc.
-1 |
Fichier paramètre non trouvé. |
-2 |
SectionListe invalide : - soit SectionListe est vide, - soit le fichier de données est un fichier paramètre destiné à un programme EXIT et SectionListe ne fait pas partie des sections autorisées. |
-4 |
SectionElt est trop petit pour recevoir le résultat de la fonction. |
-10 |
L'élément de liste souhaité n'existe pas : - soit aucun positionnement dans la section liste n'a été effectué précédemment grâce aux fonctions PgExToolFirstItemSection, PgExToolLastItemSection, PgExToolNextItemSection ou PgExToolPreviousItemSection; par conséquent, le positionnement sur l'élément courant n'est pas autorisé. - soit la liste est vide. |
Exemple
/* Cet exemple manipule un fichier paramètre
/* destiné à un programme EXIT lors d'une validation de correction
ALPHA(256) |
FicParam |
|
PARAM |
FicParam |
/* paramètre d'appel du programme EXIT |
ALPHA(40) |
SectionListe |
ALPHA(50) |
SectionElt |
NUM_BIN_4 |
TailleSection |
NUM_BIN_4 |
CodeRetour |
/* Début de programme : chargement de la dll PgExTool
CHARGER_DLL 'PgExTool'
SectionListe = 'OBJET_RECU'
TailleSection = 50
/* Manipulations de la section liste avec les fonctions
/* PgExToolFirstItemSection, PgExToolLastItemSection,
/* PgExToolNextItemSection ou PgExToolPreviousItemSection
...
...
/* lecture de la dernière section élément manipulée de la liste
APPELER_DLL 'PgExTool' 'PgExToolItemSectionInUse' FicParam SectionListe SectionElt TailleSection CodeRetour
SI CodeRetour = 0
/* SectionElt est renseignée et peut être utilisée
/* avec les fonctions PgExToolReadValue et PgExToolWriteValue
...
FIN
/* Fin de programme : déchargement de la dll PgExTool
DECHARGER_DLL 'PgExTool'
Cliquez ci-dessous pour plus d'informations sur :
les programmes EXIT.