CAPTION$(N)

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

CAPTION$().bas 
' créer un BUTTON
button 1
' lui faire visualiser un intitulé
caption 1,"Calculer"
' imprimer ce texte
print
print
print caption$(1)

EN RAPPORT

BUTTON

ALPHA

FORM

CHECK

OPTION

SUB_MENU