version 6.0
dr_Lire reference (zone; cible) Entier long
| Paramètre | Type | Description | |
| zone | Entier long | Zone 4D Draw | |
| cible | Entier long | -2 = Par défaut, -1= Tous, 0 = Sélection, >0 = ID | |
| Résultat | Entier long | Référence numérique |
Description
La commande dr_Lire reference retourne la référence numérique de l'objet désigné par cible. Une référence numérique est un nombre de type Entier long associé à un objet. Cette référence n'a pas de caractère d'unicité et ne pourra être manipulée que par méthode à l'aide de la commande dr_FIXER REFERENCE.
Si cible est égal à -2, dr_Lire reference retourne la référence numérique par défaut définie pour chaque objet créé dans la zone, lorsqu'une référence par défaut existe. Ce numéro ne peut être défini que par programmation. S'il n'existe pas, dr_Lire reference retourne 0.
Si cible est égal à -1, dr_Lire reference retourne la référence numérique des éléments contenus dans zone.
Si cible est égal à 0, dr_Lire reference retourne la référence numérique des éléments sélectionnés.
Note : Dans ces deux derniers cas, si les références diffèrent, dr_Lire reference retourne - 32000 et dr_Erreur renvoie l'erreur n°29.
Si cible est supérieur à 0, 4D Draw interprète la valeur passée comme étant le numéro d'identification d'un objet et retourne sa référence numérique. Si le numéro d'identification ne correspond à aucun objet dans zone, dr_Lire reference retourne - 32000 et dr_Erreur renvoie 2.
Exemple
L'exemple suivant est la méthode objet d'un bouton inscrit dans un formulaire contenant une zone 4D Draw. Cette méthode objet s'assure que la sélection contient 1 élément, puis recherche parmi les enregistrements d'une table liée l'enregistrement ayant un champ Ref dont le contenu correspond à la référence numérique de la sélection. Enfin, elle affiche son descriptif dans une boîte de dialogue.
Si (1=dr_Compter(LaZone;0))
CHERCHER([Librairie];[Librairie]Ref=dr_Lire reference(LaZone;0))
ALERTE("Le descriptif de cet objet est le suivant : "+[Librairie]Descriptif)
Fin de si
Référence
dr_FIXER REFERENCE, dr_Lire ID.