version 6.0
LISTE DE CHAINES VERS TABLEAU (resNum; chaînes{; resFichier})
Paramètre | Type | Description | |
resNum | Numérique | Numéro de ressource | |
chaînes | Tableau alpha | Tableau texte ou alpha devant recevoir les chaînes | |
Chaînes de la ressource STR# | |||
resFichier | DocRef | Numéro de référence de fichier de ressources ou | |
tous les fichiers de ressources ouverts si ce | |||
paramètre est omis |
Description
La commande LISTE DE CHAINES VERS TABLEAU remplit le tableau chaînes avec les chaînes stockées dans la ressource de type liste de chaînes ("STR#") dont vous avez passé le numéro d'ID dans resNum.
Si la ressource n'est pas trouvée, le tableau chaînes reste inchangé et la variable système OK prend la valeur 0 (zéro).
Si vous passez un numéro de référence de fichier de ressources valide dans resFichier, la ressource est recherchée dans ce fichier uniquement. Si vous ne passez pas le paramètre resFichier, c'est la première occurrence de la ressource rencontrée dans la chaîne des fichiers de ressources qui sera retournée.
Si vous ne pré-déclarez pas le tableau chaînes avant d'appeler LISTE DE CHAINES VERS TABLEAU, la commande crée un tableau de type Texte. Si vous pré-déclarez le tableau, vous pouvez lui assigner le type Alpha ou Texte.
Note : Chaque chaîne d'une ressource liste de chaînes peut contenir jusqu'à 255 caractères.
Conseil : Lorsque vous utilisez des ressources listes de chaînes, limitez-vous à des ressources de 32 Ko maximum et quelques centaines de chaînes par ressource.
Exemple
Reportez-vous à l'exemple de la commande TABLEAU VERS LISTE DE CHAINES.
Référence
Lire chaine dans liste, Lire ressource chaine, Lire ressource texte, TABLEAU VERS LISTE DE CHAINES.
Variables et ensembles système
La variable système OK prend la valeur 1 si la ressource est trouvée, sinon elle prend la valeur 0 (zéro).