LISTBOX LIRE POSITION CELLULE

4D v16.3


LISTBOX LIRE POSITION CELLULE ( {* ;} objet ; colonne ; ligne {; varCol} )

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)
colonne	Entier long	Numéro de colonne
ligne	Entier long	Numéro de ligne
varCol	Pointeur	Pointeur sur la variable de colonne

Description

La commande LISTBOX LIRE POSITION CELLULE retourne les numéros de la colonne et de la ligne correspondant à l’emplacement du dernier clic ou de la dernière action de sélection effectuée dans la list box désignée par * et objet.
La commande retourne les coordonnées du clic ou de l'action de sélection même lorsque la saisie n'est pas autorisée dans la list box.

Notes :

Le numéro retourné dans le paramètre ligne ne tient pas compte de l'éventuel statut masqué/affiché des lignes de la list box.
Si le clic a eu lieu dans une cellule d'une fausse colonne, le paramètre ligne contient "n+1", où n est le nombre de colonnes de la list box (une fausse colonne peut être automatiquement ajoutée lorsque l'option "Redimensionnement colonnes auto" est sélectionnée ; pour plus d'informations, reportez-vous au paragraphe Thème Redimensionnement).

Si vous passez le paramètre facultatif *, 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.

Le paramètre facultatif varCol retourne un pointeur sur la variable (c’est-à-dire le tableau) associée à la colonne.

Cette commande peut être appelée uniquement dans le cadre d’une list box générant l’un des événements formulaire suivants :

Sur clic et Sur double clic
Sur avant frappe clavier et Sur après frappe clavier
Sur après modification
Sur gain focus et Sur perte focus
Sur données modifiées
Sur nouvelle sélection
Sur avant saisie

Lorsqu’elle est appelée en dehors de ce contexte, LISTBOX LIRE POSITION CELLULE retourne 0 dans colonne et ligne.

Cette commande tient compte des actions de sélection ou de désélection effectuées via la souris, les touches du clavier et la commande EDITER ELEMENT (qui génère l’événement Sur gain focus).

Si la sélection est modifiée via les touches fléchées du clavier, colonne retourne 0. Dans ce cas, s’il est passé, le paramètre varCol retourne Nil.

Voir aussi

LISTBOX LIRE COORDONNEES CELLULE
LISTBOX SELECTIONNER RUPTURE