LISTBOX SET TABLE SOURCE

4D v16.3


LISTBOX SET TABLE SOURCE ( {* ;} objet ; numTable \| tempo {; nomSurlignage} )

Paramètre	Type	Description
*	Opérateur	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)
numTable \| tempo	Entier long, Chaîne	Numéro de la table de laquelle utiliser la sélection courante ou Nom de la sélection temporaire à utiliser
nomSurlignage	Chaîne	Nom de l’ensemble de surlignage

Description

La commande LISTBOX SET TABLE SOURCE vous permet de modifier la source des données affichées dans la list box désignée par les paramètres * et objet.

Note : Cette commande ne peut être utilisée 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). Elle ne fait rien si vous l’utilisez avec une list box associée à des tableaux.

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 Objets de formulaires.

Si vous passez un numéro de table comme paramètre numTable, la list box sera remplie avec les données des enregistrements de la sélection courante de la table.
Si vous passez un nom de sélection temporaire comme paramètre tempo, la list box sera remplie avec les données des enregistrements appartenant à la sélection temporaire.

Le paramètre optionnel nomSurlignage vous permet d’associer un ensemble de surlignage à la list box. L’ensemble de surlignage est utilisé pour gérer le surlignage des enregistrements par l’utilisateur dans la list box.

Si la list box contenait déjà des colonnes, leur contenu est mis à jour à l’issue de l’exécution de la commande.

Note : Pour des raisons d'optimisation, cette commande est traitée de manière asynchrone, c'est-à-dire que le changement de source de la listbox n'est effectif qu'à l'issue de l'exécution complète de la méthode dans laquelle la commande est appelée.

Voir aussi

LISTBOX GET TABLE SOURCE