4D Doc Center : Utiliser des méthodes objet

4D v14.3

Utiliser des méthodes objet

Vous pouvez associer une méthode à tout objet actif d’un formulaire. Les méthodes qui sont associées à des objets individuels d’un formulaire sont appelées des méthodes objet. Une méthode objet est utilisée pour gérer l’objet auquel elle est associée.

A l’aide d’une méthode objet, vous pouvez effectuer par exemple les opérations suivantes :

Renforcer les contraintes et les règles de saisie de la base,
Initialiser et gérer les objets tels que les onglets, pop-ups/listes déroulantes, list box, combo box, menus déroulants hiérarchiques ou pop-up menus image.
Définir l’action qui est réalisée lorsque l’on clique ou double-clique sur un objet,
Gérer les opérations de glisser/déposer personnalisées.

Voici quelques exemples simples d’opérations réalisées sur les données.

La méthode suivante calcule un total basé sur les valeurs de deux champs :

Ligne_total:=[Produits]Prix *[Commandes]Quantité

Voici une méthode qui passe tous les caractères d’un champ en caractères majuscules :

[Clients]Nom:=Majusc([Clients]Nom)

La méthode suivante concatène les valeurs provenant d’un champ Prénom et d’un champ Nom et stocke le résultat dans une variable appelée vNom :

vNom:=[Employés]Prénom+" "+[Employés]Nom

Les méthodes sont créées dans l’éditeur de méthodes. Reportez-vous au chapitre pour plus d’informations sur l’utilité et l’utilisation des méthodes.

Les événements des objets

Les méthodes objet sont exécutées lorsque certains événements se produisent. Dans la plupart des cas, une méthode qui réalise une action particulière n’est exécutée que lorsqu’un événement précis se produit. Par exemple, l’action associée à un onglet ou un bouton n’a d’intérêt que lorsque l’utilisateur clique sur l'objet. Dans une zone de défilement, vous pouvez souhaiter n’exécuter une méthode que si l’utilisateur double-clique sur un élément. En outre, votre application sera exécutée plus rapidement si vous désélectionnez les événements inutiles.
Vous pouvez définir la liste des événements qui déclenchent la méthode de l’objet dans la section “Evénements” de la Liste des propriétés. La liste contient tous les événements formulaire pertinents pour l’objet sélectionné. Certains événements ne sont disponibles que pour des types d’objets spécifiques. Il existe également des événements supplémentaires, générés au niveau du formulaire uniquement. Pour une description détaillée de tous les événements formulaire, reportez-vous à la description de la commande Evenement formulaire dans le manuel Langage de 4D.

Vous sélectionnez un événement en cliquant sur la case à cocher associée. Pour sélectionner/désélectionner tous les événements en une opération, effectuez Ctrl+clic (Windows) ou Commande+clic (Mac OS) sur un événement.

Si vous avez besoin d’exécuter différentes instructions suivant l’événement, vous pouvez combiner dans la méthode objet des boucles d’instructions du type Au cas ou...Fin de cas, la fonction Evenement formulaire et les constantes du thème Evénements formulaire et tester chaque événement que vous avez sélectionné pour l’objet. Voici un exemple de structure de méthode objet de ce type :

 Au cas ou

    :(Evenement formulaire=Sur chargement)

  //Placer ici le code à exécuter à l'ouverture du formulaire

 

    :(Evenement formulaire=Sur données modifiées)

  //Placer ici le code à exécuter lorsque le contenu de l'objet est modifié

 

    :(Evenement formulaire=Sur validation)

  //Placer ici le code à exécuter lors de la validation du formulaire

 Fin de cas

Créer une méthode objet

Pour créer une méthode objet :

Dans l’éditeur de formulaires, sélectionnez l’objet auquel vous voulez associer une méthode.
Cliquez sur le bouton Edition... en regard de la ligne Méthode objet (thème “Action”) dans la Liste des propriétés.
OU
Choisissez la commande Méthode objet dans le menu Objets.
OU
Cliquez sur l’objet avec le bouton droit de la souris et choisissez la commande Méthode objet dans le menu contextuel qui apparaît.
OU
Maintenez enfoncée la touche Alt (sous Windows) ou Option (sous Mac OS) et cliquez sur le champ ou l’objet.
4D affiche une nouvelle fenêtre de l’éditeur de méthodes, vierge par défaut. Le nom de la méthode est “Méthode objet : ” suivi du nom du formulaire puis de l’objet ou du champ.
Ecrivez la méthode comme décrit dans le chapitre puis fermez la fenêtre ou enregistrez votre travail.
La méthode est désormais associée au champ ou à l’objet actif. Vous pouvez visualiser les objets associés à une méthode en affichant les badges “Méthode objet” :

Vous pouvez visualiser ou modifier une méthode à tout moment.

Ouvrir une méthode objet

Pour ouvrir une méthode objet :

Dans l’éditeur de formulaires, sélectionnez l’objet duquel vous voulez ouvrir la méthode.
Cliquez sur le bouton Edition... en regard de la ligne Méthode objet (thème “Action”) dans la Liste des propriétés.
OU
Choisissez la commande Méthode objet dans le menu Objets.
OU
Cliquez sur l’objet avec le bouton droit de la souris et choisissez la commande Méthode objet dans le menu contextuel qui apparaît.
OU
Maintenez enfoncée la touche Alt (sous Windows) ou Option (sous Mac OS) et cliquez sur le champ ou l’objet.
L’éditeur de méthodes apparaît et affiche la méthode objet, vous pouvez modifier le code.

Supprimer une méthode objet

Vous pouvez supprimer à tout moment une méthode objet que vous avez créée. Pour cela, sélectionnez l’objet auquel la méthode est associée puis choisissez Supprimer la méthode objet dans le menu Objets.