ITEM_INDEX$(N)

ITEM_INDEX$(N)

RETOURNE L'ARTICLE SELECTIONNÉ DE L'OBJET SYSTÈME NUMÉRO N


  • Type : Fonction
  • Paramètre : 1
  • Groupe : Objets Système


ACTION

La fonction ITEM_INDEX$(N) retourne la ligne (article) de l'objet système désigné par son numéro N, qui a été sélectionnée par l'utilisateur.

L'objet système est du type : COMBO, LIST.

Remarque 1 : si aucune ligne (article) n'est sélectionnée, ITEM_INDEX$(N) retourne "" (la chaîne de caractères vide).

Remarque 2 : le mot-clé ITEM_INDEX$ se termine par '$' parce que la valeur retournée est du type chaîne de caractères.


SYNTAXE : Resultat$=ITEM_INDEX$(N)

  • N = numéro de l'objet système (entier ou réel). Doit être plus grand que 0 et inférieur ou égal au nombre maximum permis d'objets systèmes.
  • Resultat$ est une chaîne de caractères.

UTILISATION

  • La fonction ITEM_INDEX$() est utilisée pour connaître la ligne sélectionnée par l'utilisateur.

ERREUR

  • Si le numéro N n'est pas une expression correcte.
  • Si le numéro N excède le nombre maximum permis d'objets systèmes.
  • Si le numéro N est inférieur à 0.
  • Si l'objet système numéro N n'existe pas.
  • Si le numéro N n'est pas le numéro d'un COMBO, un LIST.

EXEMPLE

ITEM_INDEX$().bas 
' créer un LIST
list 1
' remplir ce LIST avec 2 lignes
item_add 1,"c'est la ligne 1"
item_add 1,"c'est la ligne 2"
' imprimer l'article sélectionné
print item_index$(1)

EN RAPPORT

COMBO

LIST

FILE_ADD

ITEM_ADD

ITEM_INSERT

ITEM_DELETE

ITEM_SELECT

COUNT()

ITEM_READ$()

ITEM_INDEX()