4D Doc Center : ch

4D Chart v13

ch_Lire ID


ch_Lire ID ( zone ; cible ; indice ) -> Résultat

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
cible	Entier long	Cible de la fonction -1 = Tout, 0 = Objets sélectionnés, >0 = ID du groupe
indice	Entier long	Numéro de l’objet dans cible
Résultat	Entier long	ID de l'objet désigné par cible et indice

Description

La commande ch_Lire ID renvoie l’identifiant unique de l’objet dans zone désigné par cible et indice. Ce numéro est utilisé par beaucoup d’autres commandes 4D Chart et il constitue l’identifiant d’un objet.

Pour obtenir l’identifiant d’un objet, spécifiez d’abord à quel ensemble d’objets vous voulez faire référence, puis l’ordre de l’objet à l’intérieur de l’ensemble. Les objets sont ordonnés de l’arrière-plan vers le premier plan. L’objet le plus reculé a l'indice 1.

Si cible est égal à -1, indice fait référence à l’ordre de l’objet à l’intérieur du document dans sa totalité.
Si cible est égal à 0, indice fait référence à l’ordre de l’objet parmi les objets actuellement sélectionnés.
Si cible est supérieur à 0, ce doit être l’identifiant d’un groupe et indice fait référence à l’ordre des objets à l’intérieur du groupe. Cette dernière syntaxe permet de manipuler des objets dans un groupe sans dégrouper.

Exemple

L’exemple suivant montre comment extraire l’identifiant d’un objet sélectionné.

vID:=ch_Lire ID(Zone;0;1) `Obtenir l’identifiant du premier objet sélectionné