4D Doc Center : OBJET LIRE EVENEMENTS

4D v14.3

OBJET LIRE EVENEMENTS


OBJET LIRE EVENEMENTS ( {* ;} objet ; tabEvénements )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est un champ ou une variable
objet	Objet de formulaire	Nom d'objet ou "" pour désigner le formulaire (si * est spécifié) ou Champ ou variable (si * est omis)
tabEvénements	Tableau entier long	Tableau des événements activés

Description

La commande OBJET LIRE EVENEMENTS vous permet de d’obtenir la configuration courante des événements formulaire du formulaire, de l’objet ou des objets désigné(s) par les paramètres objet et *.

Les événements formulaire peuvent avoir été activés/désactivés soit via la Liste des propriétés, soit via la commande OBJET FIXER EVENEMENTS si elle a été appelée dans le process courant.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre objet est un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de champ ou de variable (champ ou variable objet uniquement).
Pour obtenir la configuration des événements du formulaire lui-même, passez le paramètre optionnel * et une chaîne vide "" dans objet : dans ce cas, vous désignez le formulaire courant.

Note : Si vous souhaitez obtenir les événements d’un sous-formulaire lié à une table, seule la syntaxe basée sur le nom d’objet peut être utilisée.

Passez dans le paramètre tabEvénements un tableau Entier long. A l’exécution de la commande, ce tableau est automatiquement dimensionné et reçoit tous les événements formulaire prédéfinis ou personnalisés activés pour l’objet ou le formulaire. Vous pouvez comparer les valeurs reçues aux constantes du thème "Evénements formulaire".

Attention, le tableau tabEvénements est retourné vide si aucune méthode objet n’est associée à l’objet ou si aucune méthode formulaire n’est associée au formulaire.

Exemple

Vous souhaitez activer deux événements et obtenir la liste des événements pour un objet :

 TABLEAU ENTIER LONG($TabCurEvents;0)

 TABLEAU ENTIER LONG($TabActiv;2)

 $TabActiv{1}:=Sur clic entête

 $TabActiv{2}:=Sur clic pied

 OBJET FIXER EVENEMENTS(*;"Col1";$TabActiv;Activer événements autres inchangés)

 OBJET LIRE EVENEMENTS(*;"Col1";$TabCurEvents)