List Box Object

List box de type tableau

Dans une list box de type tableau, chaque colonne est associée à un tableau 4D à une dimension ; tous les types de tableaux peuvent être utilisés, à l’exception des tableaux de pointeurs. Le nombre de lignes est basé sur le nombre d’éléments du tableau.

Par défaut, 4D affecte le nom “ColonneN” à chaque variable de colonne. You can change it, as well as other column properties, in the column properties. The display format for each column can also be defined using the OBJECT SET FORMAT command.

Les list box basées sur des tableaux peuvent être affichées sous forme de list box hiérarchiques, disposant de mécanismes spécifiques.

Avec les list box de type tableau, les valeurs des colonnes (saisie et affichage) sont gérées à l’aide des commandes du langage 4D. Vous pouvez également associer une énumération à une colonne afin de contrôler la saisie. The values of columns are managed using high-level List box commands (such as LISTBOX INSERT ROWS or LISTBOX DELETE ROWS) as well as array manipulation commands. Par exemple, pour initialiser le contenu d’une colonne, vous pouvez utiliser l’instruction suivante :

ARRAY TEXT(varCol;size)

Vous pouvez également utiliser une énumération :

LIST TO ARRAY("ListName";varCol)

Attention : Lorsqu’un objet List box contient plusieurs colonnes de tailles différentes, seul le nombre d’éléments correspondant au plus petit tableau est affiché. Il est donc conseillé de veiller à ce que chaque tableau ait le même nombre d’éléments que les autres. A noter également que si une colonne de la list box est “vide” (c'est le cas lorsque le tableau associé n'a pas été correctement déclaré ou dimensionné via le langage), la list box n'affiche aucun contenu.

List box de type sélection

Dans ce type de list box, chaque colonne peut être associée à un champ (par exemple [Employees]LastName) ou à une expression. L’expression peut être basée sur un ou plusieurs champs (par exemple [Employés]Nom+“ ”+[Employés]Prénom) ou être simplement une formule (par exempleString(Milliseconds)). L’expression peut également être une méthode projet, une variable ou un élément de tableau. You can use the LISTBOX SET COLUMN FORMULA and LISTBOX INSERT COLUMN FORMULA commands to modify columns programmatically.

Le contenu de chaque ligne est ensuite évalué en fonction d'une sélection d'enregistrements : la sélection courante d'une table ou une sélection temporaire.

Dans le cas d’une list box basée sur la sélection courante, toute modification effectuée côté base de données est automatiquement reportée dans la list box et inversement. La sélection courante est donc toujours identique aux deux emplacements.

List box collection ou entity selection

Dans ce type de list box, chaque colonne doit être associée à une expression. Le contenu de chaque ligne est ensuite évalué par élément de la collection ou par entité de l'entity selection.

Chaque élément de la collection ou chaque entité est disponible en tant qu'objet auquel on peut accéder via le mot-clé This. Une expression de colonne peut être un chemin de propriété, une méthode projet, une variable ou n'importe quelle formule, accédant à chaque entité ou objet élément de collection via This, par exemple This.<propertyPath> (ou This.value dans le cas d'une collection de valeurs scalaires). Vous pouvez utiliser les commandes LISTBOX SET COLUMN FORMULA et LISTBOX INSERT COLUMN FORMULA pour modifier les colonnes par programmation.

Lorsque la source de données est une entity selection, les modifications apportées du côté de la list box sont automatiquement enregistrées dans la base de données. En revanche, les modifications apportées du côté de la base de données sont visibles dans la list box après le rechargement des entités modifiées.

note

Lorsque des entités sont supprimées, leurs références restent dans l'entity selection avec une valeur undefined, ce qui entraîne l'affichage de lignes vides dans la list box. Dans ce cas, vous pouvez appeler la fonction .clean() pour obtenir une nouvelle entity selection sans les références d'entités supprimées.

Lorsque la source de données est une collection, toute modification apportée aux valeurs de la list box se reflète dans la collection. En revanche, si des modifications sont apportées à la collection en utilisant par exemple les diverses fonctions de la classe Collection, vous devrez en informer explicitement 4D en réaffectant la variable collection à elle-même, de sorte que le contenu de la list box soit actualisé. Par exemple :

myCol:=myCol.push("new value") //afficher new value dans la list box

Propriétés prises en charge

Les propriétés prises en charge dépendent du type de list box.

Propriété	List box tableau	Liste box sélection	List box collection ou entity selection
Couleur de fond alternée	X	X	X
Couleur de fond	X	X	X
Gras	X	X	X
Expression couleur de fond		X	X
Style de la bordure	X	X	X
Bas	X	X	X
CSS Class	X	X	X
Collection ou entity selection		X	X
Redimensionnement colonnes auto	X	X	X
Elément courant			X
Position élément courant			X
Source de données	X	X	X
Nom formulaire détaillé		X
Afficher en-têtes	X	X	X
Afficher pieds	X	X	X
Double-clic sur ligne		X
Glissable	X	X	X
Déposable	X	X	X
Focusable	X	X	X
Police	X	X	X
Couleur de la police	X	X	X
Expression couleur police		X	X
Taille	X	X	X
Hauteur (list box)	X	X	X
Hauteur (en-têtes)	X	X	X
Hauteur (pieds)	X	X	X
Masquer lignes vides finales	X	X	X
Cacher rectangle de focus	X	X	X
Cacher surlignage sélection	X	X	X
List box hiérarchique	X
Ensemble surlignage		X
Alignement horizontal	X	X	X
Couleur lignes horizontales	X	X	X
Marge horizontale	X	X	X
Barre de défilement horizontale	X	X	X
Dimensionnement horizontal	X	X	X
Italique	X	X	X
Gauche	X	X	X
Table principale		X
Meta info expression			X
Méthode	X	X	X
Lignes déplaçables	X
Sélection temporaire		X
Nombre de colonnes	X	X	X
Nombre de colonnes verrouillées	X	X	X
Nombre de colonnes statiques	X	X	X
Nom d'objet	X	X	X
Droite	X	X	X
Tableau couleurs de fond	X
Tableau de contrôle des lignes	X
Tableau couleurs de police	X
Hauteur des lignes	X
Tableau hauteurs des lignes	X
Tableau de styles	X
Eléments sélectionnés			X
Mode de sélection	X	X	X
Saisie sur clic unique	X	X	X
Triable	X	X	X
Action standard	X
Expression Style		X	X
Haut	X	X	X
Transparent	X	X	X
Type	X	X	X
Souligné	X	X	X
Variable ou expression	X	X
Alignement vertical	X	X	X
Couleur lignes verticales	X	X	X
Marge verticale	X	X	X
Barre de défilement verticale	X	X	X
Dimensionnement vertical	X	X	X
Visibilité	X	X	X
Largeur	X	X	X

Les colonnes, en-têtes et pieds de list box prennent en charge des propriétés spécifiques.

Événements de formulaire pris en charge

Evénement formulaire	Propriétés supplémentaires renvoyées (voir Form event pour les propriétés principales)	Commentaires
On After Edit	column columnName row
On After Keystroke	column columnName row
On After Sort	column columnName headerName	Les formules composées ne peuvent pas être triées. (ex : This.firstName + This.lastName)
On Alternative Click	column columnName row	Listbox tableau uniquement
On Before Data Entry	column columnName row
On Before Keystroke	column columnName row
On Begin Drag Over	column columnName row
On Clicked	column columnName row
On Close Detail	row	Current Selection & Named Selection list boxes only
On Collapse	column columnName row	List box hiérarchiques uniquement
On Column Moved	columnName newPosition oldPosition
On Column Resize	column columnName newSize oldSize
On Data Change	column columnName row
On Delete Action	row
On Display Detail	isRowSelected row
On Double Clicked	column columnName row
On Drag Over	area areaName column columnName row
On Drop	column columnName row
On Expand	column columnName row	List box hiérarchiques uniquement
On Footer Click	column columnName footerName	Arrays, Current Selection & Named Selection list boxes only
On Getting Focus	column columnName row	Propriétés supplémentaires retournées uniquement lors de la modification d'une cellule
On Header Click	column columnName headerName
On Load
On Losing Focus	column columnName row	Propriétés supplémentaires retournées uniquement lorsque la modification d'une cellule est achevée
On Mouse Enter	area areaName column columnName row
On Mouse Leave
On Mouse Move	area areaName column columnName row
On Open Detail	row	Current Selection & Named Selection list boxes only
On Row Moved	newPosition oldPosition	Listbox tableau uniquement
On Selection Change
On Scroll	horizontalScroll verticalScroll
On Unload

Propriétés supplémentaires

Les événements formulaire sur les list box ou colonnes de list box peuvent retourner les propriétés supplémentaires suivantes :

Propriété	Type	Description
area	text	Zone de l'objet List box ("header", "footer", "cell")
areaName	text	Nom de la zone
column	entier long	Numéro de colonne
columnName	text	Nom de la colonne
footerName	text	Nom du pied
headerName	text	Nom de l'en-tête
horizontalScroll	entier long	Positif si le défilement est vers la droite, négatif s'il est vers la gauche
isRowSelected	boolean	Vrai si la ligne est sélectionnée, sinon Faux
newPosition	entier long	Nouvelle position de la colonne ou de la ligne
newSize	entier long	Nouvelle taille (en pixels) de la colonne ou de la ligne
oldPosition	entier long	Position précédente de la colonne ou de la ligne
oldSize	entier long	Taille précédente (en pixels) de la colonne ou de la ligne
row	entier long	Numéro de ligne
verticalScroll	entier long	Positif si le défilement est vers le bas, négatif s'il est vers le haut

Si un événement se produit sur une "fake" colonne ou ligne qui n'existe pas, une chaîne vide est généralement renvoyée.