INSERER COLONNE LISTBOX

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11 (Modifiée)


INSERER COLONNE LISTBOX ({*; }objet; positionCol; nomCol; variableCol; nomEntête; variableEntête)

ParamètreTypeDescription
**Si spécifié, objet est un nom d'objet (chaîne)
Si omis, objet est une variable
objetObjet de formulaireNom d'objet (si * est spécifié) ou
Variable (si * est omis)
positionColNumériqueEmplacement de la colonne à insérer
nomColChaîneNom d'objet de la colonne
variableColTab | Champ | VarNom de la variable tableau de la colonne
ou champ ou variable
nomEntêteChaîneNom d'objet de l'en-tête de la colonne
variableEntêteVar EntierVariable d'en-tête de la colonne

Description

La commande INSERER COLONNE LISTBOX insère une colonne dans la list box désignée par les paramètres objet et *.

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 les paramètres nomCol et variableCol le nom d'objet et la variable de la colonne insérée.

Dans le cadre d'une list box de type tableau, le nom de la variable correspond au nom du tableau dont le contenu sera affiché dans la colonne.

Dans le cadre d'une list box de type sélection, vous pouvez passer un champ ou une variable dans le paramètre variableCol. Le contenu de la colonne sera alors la valeur du champ ou de la variable, évaluée pour chaque enregistrement de la sélection associée à la list box. 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 (cf. section Gestion programmée des objets de type List box). Vous pouvez utiliser des champs ou des variables de type chaîne, numérique, Date, Heure, Image et Booléen.

Dans le contexte de list box basées sur des sélections, INSERER COLONNE LISTBOX permet d'insérer des éléments simples (champs ou variables). Si vous souhaitez manipuler des expressions plus complexes (telles que des formules ou des méthodes), vous devez utiliser la commande INSERER COLONNE FORMULE LISTBOX.

Note : Il n'est pas possible de combiner dans une même list box des colonnes de type tableau (source de données tableaux) et des colonnes de type champ ou variable (source de données sélection).

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.

Exemples

(1) Nous souhaitons ajouter une colonne à la fin de la list box :

   C_ENTIER LONG(NomVarHeader;$Der;$NbEnr)
   TOUT SELECTIONNER([Table 1])
   $NbEnr:=Enregistrements dans table([Table 1])
   TABLEAU IMAGE(tabImage;$NbEnr)

   $Der:=Lire nombre colonnes listbox(*;"ListBox1")+1
   INSERER COLONNE LISTBOX(*;"ListBox1";$Der;"ColumnPicture";tabImage;"HeaderPicture";NomVarHeader)

(2) Nous souhaitons ajouter une colonne à la droite de la list box et lui associer les valeurs du champ [Envois]Frais :

   $der:=Lire nombre colonnes listbox(*;"ListBox1")+1
   INSERER COLONNE LISTBOX(*;"ListBox1";$der;"ColChamp";[Envois]Frais;"NomEntete";VarEntete)

Référence

INSERER COLONNE FORMULE LISTBOX, SUPPRIMER COLONNE LISTBOX.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant