ch_Lire reference

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

version 1


ch_Lire reference (zone; cible) Entier long

ParamètreTypeDescription
zoneEntier longZone 4D Chart
cibleEntier longCible de la fonction
-2 = Par défaut, -1 = Tout, 0 = Objets sélectionnés,
>0 = ID de l'objet
RésultatEntier longNuméro de référence du ou des objet(s)
désignés par cible

Description

La commande ch_Lire reference renvoie le numéro de référence du ou des objet(s) désigné(s) par cible et zone.

Un numéro de référence est un entier long associé à un objet, et il n'est pas obligatoirement unique. Les numéros de référence ne peuvent être manipulés que par méthode. C'est vous qui affectez un numéro de référence à un objet, mais c'est 4D Chart qui lui affecte son identifiant.

Si cible est égal à -2, ch_Lire reference renvoie le numéro de référence par défaut.

Si cible est égal à -1, ch_Lire reference renvoie le numéro de référence de tous les objets contenus dans le document. Si les numéros de référence des objets ne sont pas égaux, ch_Lire reference renvoie -32000.

Si cible est égal à 0, ch_Lire reference renvoie le numéro de référence des objets sélectionnés. Si les numéros de référence des objets ne sont pas égaux, ch_Lire reference renvoie -32000.

Si cible est supérieur à 0, il doit être égal à l'identifiant d'un objet spécifique et le numéro de référence de celui-ci est renvoyé. Si l'objet n'existe pas, ch_Lire reference renvoie -32000.

Exemple

L'exemple suivant est la méthode objet d'un bouton inscrit dans un formulaire contenant une zone 4D Chart. Lors de son exécution, la méthode objet assure qu'un seul objet est sélectionné, recherche l'enregistrement correspondant dans la table [Parts], et affiche sa description.

   CHERCHER ([Parts];[Parts]Refnum = ch_Lire reference (Zone;0))
   ALERTE ("Cet objet est un " + [Parts]Description)

Référence

ch_FIXER REFERENCE, ch_Lire ID.


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