dr_Lire reference

4D - Documentation   Français   English   German   4D Draw 2004, Commandes par thèmes   4D Draw 2004, Liste alphabétique des commandes   Retour   Précédent   Suivant

version 6.0


dr_Lire reference (zone; cible) Entier long

ParamètreTypeDescription
zoneEntier longZone 4D Draw
cibleEntier long-2 = Par défaut, -1= Tous, 0 = Sélection, >0 = ID
RésultatEntier longRé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.


4D - Documentation   Français   English   German   4D Draw 2004, Commandes par thèmes   4D Draw 2004, Liste alphabétique des commandes   Retour   Précédent   Suivant