CAPTION$()

CAPTION$(N)

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

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

ACTION

La fonction CAPTION$(N) retourne l'intitulé (CAPTION) de l'objet système numéro N.

L'objet système doit être de l'un des types suivants: BUTTON, ALPHA, FORM, CHECK, OPTION, SUB_MENU.

Remarque 1: si aucun intitulé n'a été affecté à l'objet système, CAPTION$(N) retourne "" (la chaîne de caractères vide).

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

SYNTAXE : Resultat$=CAPTION$(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 CAPTION$() est utilisée pour connaître l'intitulé d'un objet système.

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 BUTTON, ALPHA, FORM, CHECK, OPTION, SUB_MENU.

EXEMPLE

rem créer un BUTTON

button 1

rem lui faire visualiser un intitulé

caption 1,"Calculer"

rem imprimer ce texte

print

print

print caption$(1)

EN RAPPORT

BUTTON

ALPHA

FORM

CHECK

OPTION

SUB_MENU