LIST

LIST N

CRÉE UN OBJET SYSTÈME LIST ET LUI DONNE LE NUMÉRO N COMME RÉFÉRENCE

  • Type: Commande
  • Paramètre: 1
  • Groupe: Création Objets Système

ACTION

La commande LIST N crée un objet système LIST et lui donne un numéro N. Le numéro N sera utilisé pour désigner ce LIST.

Le LIST créé peut alors être utilisé par les commandes appropriées.

Le LIST est créé à la position (0,0) : c'est à dire TOP = 0 pixel et LEFT = 0 pixel, avec les dimensions WIDTH = 121 pixels et HEIGHT = 97 pixels.

Un LIST montre une liste de choix et l'utilisateur peut choisir un article.

Un LIST peut générer les événements : ON_CLICK, ON_DOUBLE_CLICK, ON_KEY_UP, ON_KEY_DOWN.

Remarque 1: par défaut, le LIST est créé sur le FORM numéro 0, mais un autre FORM peut être utilisé. Pour cela, créer un FORM par FORM N et lui envoyer les commandes par COMMAND_TARGET_IS N avant la création du LIST.

Remarque 2: si le LIST est rempli complètement, l'addition d'un nouvel item provoque automatiquement l'apparition d'un ascenseur vertical.

Remarque 3: un LIST se remplit avec les commandes ITEM_ADD, ITEM_INSERT, FILE_LOAD ou FILE_ADD, et se lit avec la fonction ITEM_READ$().

SYNTAXE : LIST N

  • N = numéro d'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.

UTILISATION

  • Un LIST est utilisé pour montrer une liste de choix dont l'utilisateur peut choisir un article.

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 ou égal à 0.
  • Si le numéro N est déjà utilisé pour un numéro d'objet système.

EXEMPLE

rem crée un LIST avec la position et les dimensions par défaut

list 1

rem lui ajouter un article

item_add 1,"Salut!"

EN RAPPORT

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

COLOR

ITEM_ADD

ITEM_INSERT

ITEM_DELETE

ITEM_READ$()

FILE_ADD

FILE_LOAD

CLEAR

ON_CLICK