LISTBOX GET CELL POSITION
LISTBOX GET CELL POSITION* ( {* ;} objet {; x ; y }; 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 | any | → | Nom d’objet (si * est spécifié) ou Variable (si * est omis) |
| x | Real | → | Coordonnée horizontale de la souris |
| y | Real | → | Coordonnée verticale de la souris |
| colonne | Integer | ← | Numéro de colonne |
| ligne | Integer | ← | Numéro de ligne |
| varCol | Pointer | ← | Pointeur sur la variable de colonne |
Description
a commande LISTBOX GET CELL POSITION retourne les numéros de la colonne et de la ligne correspondant à l’emplacement du dernier clic, de la dernière action de sélection effectuée ou des coordonnées horizontale et verticale de la souris dans la list box désignée par * et objet.
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.
Si les paramètres x et y sont omis, la commande retourne les coordonnées du clic ou de l'action de sélection. Si les paramètres x et y sont passés, la commande retourne les numéros de colonne et de ligne correspondant aux coordonnées de la souris. Dans les deux cas, la commande retourne des valeurs valides 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. Il peut également valoir 0 si le clic ou la position y est situé(e) au-delà de la dernière ligne.
- Si le clic ou la position x correspond à 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.
- Dans une list box hiérarchique, la valeur de la colonne prend en compte la ou les colonnes fusionnées pour représenter la hiérarchie.
Le paramètre facultatif varCol retourne un pointeur sur la variable (c’est-à-dire le tableau) associée à la colonne.
Lorsque les paramètres x et y ne sont pas utilisés, cette commande peut être appelée uniquement dans le cadre d’une list box générant l’un des événements formulaire suivants :
- On Clicked et On Double Clicked
- On Before Keystroke et On After Keystroke
- On After Edit
- On Getting Focus et On Losing Focus
- On Data Change
- On Selection Change
- On Before Data Entry
Lorsqu’elle est appelée en dehors de ce contexte, LISTBOX GET CELL POSITION 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 EDIT ITEM (qui génère l’événement On Getting 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 Is nil pointer.
Voir aussi
LISTBOX GET CELL COORDINATES
LISTBOX SELECT BREAK
Propriétés
| Numéro de commande | 971 |
| Thread safe | ✗ |