4D Doc Center : OBJET FIXER EVENEMENTS

4D v14.3

OBJET FIXER EVENEMENTS


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

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 d’événements à définir
mode	Entier long	Mode d’activation des événements définis dans tabEvénements

Description

La commande OBJET FIXER EVENEMENTS vous permet de modifier, pour le process courant, la configuration des événements formulaire du formulaire, de l’objet ou des objets désigné(s) par les paramètres objet et *.

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 définir 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 modifier 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 contenant la liste des événements formulaire prédéfinis ou personnalisés que vous souhaitez modifier (le paramètre mode permet de préciser si la modification consiste à activer ou désactiver les événements). Pour désigner un événement prédéfini à modifier, vous pouvez passer dans chaque élément du tableau tabEvénements une des constantes suivantes, placées dans le thème "Evénements formulaire" :

Constante	Type	Valeur	Commentaire
Sur action suppression	Entier long	58	(Listes hiérarchiques et List box) L’utilisateur a demandé à supprimer un élément
Sur activation	Entier long	11	La fenêtre du formulaire passe au premier plan
Sur affichage corps	Entier long	8	Un enregistrement va être affiché dans la liste ou une ligne va être affichée dans la list box
Sur appel extérieur	Entier long	10	Le formulaire a reçu un appel de la commande APPELER PROCESS
Sur appel zone du plug in	Entier long	19	Un plug-in demande que sa méthode objet soit exécutée
Sur après frappe clavier	Entier long	28	Un caractère vient d'être saisi dans l'objet qui a le focus. Lire texte edite retourne le contenu avec ce caractère.
Sur après modification	Entier long	45	Le contenu de l'objet saisissable qui a le focus vient d'être modifié
Sur après tri	Entier long	30	(List box uniquement) Un tri standard vient d'être effectué dans une colonne de list box
Sur avant frappe clavier	Entier long	17	Un caractère vient d'être saisi dans l'objet qui a le focus. Lire texte edite retourne le contenu sans ce caractère
Sur avant saisie	Entier long	41	(List box uniquement) Une cellule de list box est sur le point de passer en mode édition
Sur bouton barre outils Mac	Entier long	55	L’utilisateur a cliqué sur le bouton de gestion de la barre d’outils sous Mac OS
Sur case de fermeture	Entier long	22	On a cliqué sur la case de fermeture de la fenêtre
Sur chargement ligne	Entier long	40	En mode saisie en liste, un enregistrement est chargé en modification (l’utilisateur a cliqué sur la ligne de l’enregistrement et un champ passe en édition)
Sur chargement ressource URL	Entier long	48	(Zones Web uniquement) Une nouvelle ressource est chargée dans la zone Web
Sur clic	Entier long	4	Un clic est survenu sur un objet
Sur clic entête	Entier long	42	(List box uniquement) Un clic est survenu dans l’en-tête d’une colonne de list box
Sur clic flèche	Entier long	38	(Boutons 3D uniquement) La zone “flèche” d'un bouton 3D reçoit un clic
Sur clic long	Entier long	39	(Boutons 3D uniquement) Un bouton 3D reçoit un clic et le bouton de la souris reste enfoncé pendant un certain laps de temps
Sur clic pied	Entier long	57	(List box uniquement) Un clic est survenu dans le pied d’une list box ou d’une colonne de list box
Sur contracter	Entier long	44	(Listes hiérarchiques et list box hiérarchiques) Un élément de liste hiérarchique ou de list box hiérarchique a été contracté via un clic ou une touche du clavier
Sur début chargement URL	Entier long	47	(Zones Web uniquement) Un nouvel URL est chargé dans la zone Web
Sur début glisser	Entier long	46	Un objet est en cours de glisser
Sur début survol	Entier long	35	Le curseur de la souris entre dans la zone graphique d’un objet
Sur défilement image	Entier long	59	L'utilisateur fait défiler le contenu d'un champ ou d'une variable image à l'aide de la souris ou d'une touche du clavier.
Sur déplacement colonne	Entier long	32	(List box uniquement) Une colonne de list box est déplacée par l’utilisateur via le glisser-déposer
Sur déplacement ligne	Entier long	34	(List box uniquement) Une ligne de list box est déplacée par l’utilisateur via le glisser-déposer
Sur déployer	Entier long	43	(Listes hiérarchiques et List box hiérarchiques) Un élément de liste hiérarchique ou de list box hiérarchique a été déployé via un clic ou une touche du clavier
Sur déposer	Entier long	16	Des données sont déposées sur un objet
Sur désactivation	Entier long	12	La fenêtre du formulaire passe en arrière-plan
Sur données modifiées	Entier long	20	Les données d'un objet ont été modifiées
Sur double clic	Entier long	13	Un double-clic est survenu sur un objet
Sur entête	Entier long	5	L'en-tête du formulaire va être imprimé ou affiché
Sur erreur chargement URL	Entier long	50	(Zones Web uniquement) Une erreur s'est produite durant le chargement de l'URL
Sur fermeture corps	Entier long	26	Le formulaire détaillé se referme et on retourne au formulaire sortie
Sur filtrage URL	Entier long	51	(Zones Web uniquement) Un URL a été bloqué par la zone Web
Sur fin chargement URL	Entier long	49	(Zones Web uniquement) Toutes les ressources de l'URL ont été chargées
Sur fin survol	Entier long	36	Le curseur de la souris sort de la zone graphique d’un objet
Sur gain focus	Entier long	15	Un objet de formulaire prend le focus
Sur glisser	Entier long	21	Des données sont glissées sur un objet
Sur impression corps	Entier long	23	Le corps du formulaire va être imprimé
Sur impression pied de page	Entier long	7	Le pied de page du formulaire va être imprimé
Sur impression sous total	Entier long	6	Une rupture du formulaire va être imprimée
Sur libération	Entier long	24	Le formulaire se referme et est déchargé
Sur menu sélectionné	Entier long	18	Une commande de menu a été sélectionnée
Sur minuteur	Entier long	27	Le nombre de ticks défini par FIXER MINUTEUR est atteint
Sur modif variable liée	Entier long	54	La variable liée à un sous-formulaire est modifiée.
Sur nouvelle sélection	Entier long	31	List box : la sélection courante de lignes ou de colonnes est modifiée Enregistrements en liste : l’enregistrement courant ou la sélection courante de lignes est modifié(e) dans un formulaire en liste ou un sous-formulaire Liste hiérarchique : la sélection dans la liste est modifiée à la suite d’un clic ou de la frappe d’une touche au clavier Variable ou champ saisissable : la sélection de texte ou la position du curseur dans la zone est modifiée à la suite d’un clic ou de la frappe d’une touche au clavier
Sur ouverture corps	Entier long	25	Le formulaire détaillé associé au formulaire sortie ou à la listbox est sur le point d'être ouvert
Sur ouverture lien externe	Entier long	52	(Zones Web uniquement) Un URL externe a été ouvert dans le navigateur
Sur perte focus	Entier long	14	Un objet de formulaire perd le focus
Sur redimensionnement	Entier long	29	La fenêtre du formulaire est redimensionnée
Sur redimensionnement colonne	Entier long	33	(List box uniquement) La largeur d’une colonne de list box est modifiée
Sur refus ouverture fenêtre	Entier long	53	(Zones Web uniquement) Une fenêtre pop up a été bloquée
Sur survol	Entier long	37	Le curseur de la souris a bougé d’au moins un pixel OU une touche de modification (Ctrl, Alt, Verr Maj.) a été enfoncée. Si l'événement est coché pour un objet uniquement, il n'est généré que lorsque le curseur se trouve dans la zone graphique de l'objet
Sur validation	Entier long	3	La saisie des données dans l'enregistrement est validée

Il est important de noter que l’événement Sur chargement est absent de cette liste : il ne peut pas être défini, car lors de l’exécution de la commande il a déjà été généré.

Vous pouvez également passer dans tabEvénements toute valeur correspondant à un événement personnalisé. Dans ce cas, il est recommandé d’utiliser des valeurs négatives (cf. commande APPELER CONTENEUR SOUS FORMULAIRE).

Le paramètre mode vous permet de définir le traitement global à effectuer pour les éléments du tableau. Pour cela, vous pouvez passer une des constantes suivantes, placées dans le thème "Objets de formulaire (Propriétés)" :

Constante	Type	Valeur	Commentaire
Activer événements autres inchangés	Entier long	1	Tous les événements listés dans le tableau tabEvénements sont activés, le statut des autres événements est inchangé
Activer événements inactiver autres	Entier long	0	Tous les événements listés dans le tableau tabEvénements sont activés, tous les autres événements sont désactivés
Inactiver événements autres inchangés	Entier long	2	Tous les événements listés dans le tableau tabEvénements sont désactivés, le statut des autres événements est inchangé

La commande OBJET FIXER EVENEMENTS peut entraîner l’activation d’événements non pris en charge par l’objet (en fonction de son type). Dans ce cas, les événements seront simplement ignorés.

Si un objet est dupliqué après l’appel de la commande OBJET FIXER EVENEMENTS, la configuration résultante d’activation/désactivation de chaque événement est également dupliquée.

Exemple 1

Activation de trois événements formulaire pour un ensemble d’objets list box, et désactivation des autres événements :

 TABLEAU ENTIER LONG($MyEventsOnLB;3)

 $MyEventsOnLB {1}:=Sur après tri

 $MyEventsOnLB {2}:=Sur déplacement colonne

 $MyEventsOnLB {3}:=Sur redimensionnement colonne

 OBJET FIXER EVENEMENTS(*;"MesLB@";$MyEventsOnLB;Activer événements inactiver autres)

      // active 3 événements et désactive tous les autres

Exemple 2

Désactivation de trois événements formulaire pour un ensemble d’objets list box, sans modifier les autres événements :

 TABLEAU ENTIER LONG($MyEventsOnLB;3)

 $MyEventsOnLB {1}:=Sur après tri

 $MyEventsOnLB {2}:=Sur déplacement colonne

 $MyEventsOnLB {3}:=Sur redimensionnement colonne

 OBJET FIXER EVENEMENTS(*;"MesLB@";$MyEventsOnLB;Inactiver événements autres inchangés)

     // désactive uniquement les 3 événements

Exemple 3

Activation d’un événement formulaire pour un objet, sans modifier les autres événements :

 TABLEAU ENTIER LONG($MyEventsOnLB;1)

 $MyEventsOnLB {1}:=Sur déplacement colonne

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

     // active uniquement l’événement

Exemple 4

Désactivation de tous les événements du formulaire :

 TABLEAU ENTIER LONG($MyFormEvents;0)

 OBJET FIXER EVENEMENTS(*;"";$MyFormEvents;Activer événements inactiver autres)

     // désactive tous les événements

Exemple 5

Désactivation d’un seul événement du formulaire sans modifier les autres :

 TABLEAU ENTIER LONG($MyFormEvents;1)

 $MyFormEvents{1}:=Sur minuteur

 OBJET FIXER EVENEMENTS(*;"";$MyFormEvents;Inactiver événements autres inchangés)

     // désactive uniquement l’événement