GOTO SELECTED RECORD
GOTO SELECTED RECORD ( {laTable ;} enregistrement )
| Paramètre | Type | Description | |
|---|---|---|---|
| laTable | Table | 🡒 | Table dans laquelle aller à l'enregistrement spécifié ou Table par défaut si ce paramètre est omis |
| enregistrement | Entier long | 🡒 | Position de l'enregistrement dans la sélection |
Description
La commande GOTO SELECTED RECORD fait de l'enregistrement spécifié parmi la sélection courante de laTable l'enregistrement courant. La sélection courante n'est pas modifiée. Le paramètre enregistrement n'est pas équivalent au numéro retourné par Record number. Ce paramètre représente la position de l'enregistrement au sein de la sélection courante. Cette position dépend de la manière dont la sélection a été créée et si elle a été triée.
Pour plus de précisions sur les numéros d'enregistrements, reportez-vous à la section A propos des numéros d'enregistrements.
GOTO SELECTED RECORD ne fait rien si :
- il n'y a aucun enregistrement dans la sélection courante
- enregistrement n'appartient pas à la sélection courante,
- enregistrement est déjà l'enregistrement courant.
Si vous passez 0 dans enregistrement, il n’y a plus d’enregistrement courant dans laTable. Ce mécanisme permet de n'avoir plus aucun enregistrement sélectionné dans une liste, notamment dans les sous-formulaires inclus, lorsque le mode de sélection est “unique”.
Exemple
L'exemple suivant charge les valeurs du champ [Personnes]Nom dans le tableau taNoms. Un tableau d'entiers longs, numEnr, est rempli avec des numéros qui représenteront ceux des enregistrements sélectionnés. Les deux tableaux sont alors triés :
// Créer ici la sélection de la table [Personnes]
//...
// Récupérer les noms
SELECTION TO ARRAY([Personnes]Nom;taNoms)
// Créer un tableau pour les numéros d'enregistrements sélectionnés
$vELNbEnrgs:=Size of array(taNoms)
ARRAY LONGINT(numEnr;$vELNbEnrgs)
For($Enrg;1;$vELNbEnrgs) // Remplir le tableau avec ces numéros
numEnr{$Enrg}:=$Enrg
End for
// Trier les deux tableaux par ordre alphabétique
SORT ARRAY(taNoms;numEnr;>)
Si le tableau taNoms est affiché dans une zone de défilement, l'utilisateur peut cliquer sur l'un des éléments. Comme les deux tableaux ont été triés de manière synchronisée, tout élément de numEnr fournit le numéro de l'enregistrement sélectionné pour lequel le nom a été stocké dans l'élément de taNoms correspondant.
La méthode objet de la zone de défilement taNoms suivante sélectionne le bon enregistrement dans la sélection de [Personnes] en fonction de ce que l'utilisateur a choisi dans la zone de défilement.
Case of
:(Form event code=On Clicked)
If(taNoms#0)
GOTO SELECTED RECORD(numEnr{taNoms})
End ifEnd case