|
|
|
|
|
|
|
|
|
|
|
version 11
INSERER COLONNE FORMULE LISTBOX ({*; }objet; positionCol; nomCol; formule; typeDonnées; nomEntête; variableEntête)
| Paramètre | Type | Description | |
| * | * |  | Si spécifié, objet est un nom d'objet (chaîne) |
| Si omis, objet est une variable | |||
| objet | Objet de formulaire | | Nom d'objet (si * est spécifié) ou |
| Variable (si * est omis) | |||
| positionCol | Numérique | | Emplacement de la colonne à insérer |
| nomCol | Chaîne | | Nom d'objet de la colonne |
| formule | Chaîne | | Formule 4D associée à la colonne |
| typeDonnées | Entier long | | Type de résultat de la formule |
| nomEntête | Chaîne | | Nom d'objet de l'en-tête de la colonne |
| variableEntête | Var Entier | | Variable d'en-tête de la colonne |
Description
La commande INSERER COLONNE FORMULE LISTBOX insère une colonne dans la list box désignée par les paramètres objet et *.
La commande INSERER COLONNE FORMULE LISTBOX est semblable à la commande INSERER COLONNE LISTBOX, à la différence près qu'elle permet la saisie d'une formule comme contenu de la colonne.
Ce type de contenu ne peut être utilisé que lorsque la propriété "Source de données" de la list box est Sélection courante ou Sélection temporaire (pour plus d'informations sur ce point, reportez-vous à la section Gestion programmée des objets de type List box).
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d'objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable. Pour plus d'informations sur les noms d'objets, reportez-vous à la section Propriétés des objets.
La nouvelle colonne est insérée juste avant la colonne désignée par le paramètre positionCol. Si le paramètre positionCol est supérieur au nombre total de colonnes, la colonne est ajoutée après la dernière colonne.
Passez dans le paramètre nomCol le nom d'objet de la colonne insérée.
Le paramètre formule peut contenir toute expression valide, soit :
• une instruction,
• une formule générée à l'aide de l'éditeur de formules,
• un appel à une commande 4D,
• un appel à une méthode projet.
Au moment de l'appel de la commande, la formule est analysée puis exécutée.
Note : Utilisez la commande Nom commande afin de définir des formules indépendantes de la langue de l'application (lorsqu'elles font appel à des commandes 4D).
Le paramètre typeDonnées permet de désigner le type des données issues de l'exécution de la formule. Vous devez passer dans ce paramètre une des constantes du thème "Types champs et variables" suivantes :
| Constante | Type | Valeur |
| Est un numérique | Entier long | 1 |
| Est un texte | Entier long | 2 |
| Est une image | Entier long | 3 |
| Est une date | Entier long | 4 |
| Est un booléen | Entier long | 6 |
| Est une heure | Entier long | 11 |
Si le résultat de la formule ne correspond pas au type de données attendu, une erreur est générée.
Passez dans les paramètres nomEntête et variableEntête le nom d'objet et la variable de l'en-tête de la colonne insérée.
Note : Les noms d'objets doivent être uniques dans un formulaire. Vous devez veiller à ce que les noms passés dans les paramètres nomCol et nomEntête ne soient pas déjà utilisés. Sinon, la colonne n'est pas créée et une erreur est générée.
Exemple
Nous souhaitons ajouter une nouvelle colonne à la droite de la list box qui contiendra une formule calculant l'âge de l'employé :
vAge:="Date du jour-[Employés]DateNaissance)\365" $der:=Lire nombre colonnes listbox(*;"ListBox1")+1 INSERER COLONNE FORMULE LISTBOX(*;"ListBox1";$der;"ColFormule";vAge;Est un numérique;"Age";VarEntete)
Référence
|
|
|
|
|
|
|
|
|
|
|