This

4D v17.4

This


This -> Résultat

Paramètre	Type	Description
Résultat	Objet	Elément courant

Description

La commande This retourne une référence vers l'objet en cours de traitement.

Cette commande est destinée à une utilisation dans le contexte suivant :

une list box associée à une collection ou une sélection d'entités (entity selection)
pendant l'événement formulaire Sur affichage corps ou l'événement formulaire Sur données modifiées

Dans ce contexte, elle retourne une référence vers l'élément de collection ou l'entité auquel/à laquelle la list box accède afin d'afficher les valeurs des colonnes de la ligne courante. Dans tout autre contexte, elle retourne Null.

Vous pouvez accéder à toutes les propriétés des éléments ou tous les attributs d'entités via This.<cheminPropriété>. Par exemple, This.prénom ou This.employeur.nom sont des chemins de propriétés d'éléments ou d'entités (attributs) valides.

Note : Si vous utilisez une collection de valeurs scalaires, 4D crée un un objet pour chaque élément avec une seule propriété value. La valeur scalaire est alors disponible via l'expression This.value.

Exemple 1

Vous disposez d'une collection d'objets, chacun ayant la structure suivante :

{  
"ID": 1234
"name": "Xavier",  
"revenues": 47300,  
"employees": [  
             "Allan",  
             "Bob", 
             "Charlie"  
            ] 
},{  
"ID": 2563
"name": "Carla",  
"revenues": 55000,  
"isFemale": true
"employees": [  
             "Igor",  
             "Jane"  
            ] 
},...

Dans la list box, chaque colonne référence une des propriétés des objets, soit directement (This.name), soit indirectement (This.employees.length), ou encore via une expression (getPicture) qui peut être appelée directement.

La list box est configurée de la manière suivante :

La méthode projet GetPicture est appelée automatiquement dans l'événement formulaire Sur affichage corps:

  //Méthode GetPicture

 C_IMAGE($0)

 Si(This.isFemale)

    $0:=Form.genericFemaleImage

 Sinon

    $0:=Form.genericMaleImage

 Fin de si

Lorsque le formulaire est exécuté, vous pouvez visualiser le résultat :

Exemple 2

Vous souhaitez utiliser des entités de la structure suivante dans une list box :

Vous créez une list box du type "Collection ou entity selection" avec la définition suivante :

A noter que :

This.ID, This.Title et This.Date se réfèrent directement aux attributs correspondants dans la dataclass ds.Event.
This.meetings est un attribut relationnel (basé sur le nom du lien retour) qui retourne une sélection d'entités de la dataclass ds.Meeting.
Form.eventList est la sélection d'entités qui est associée à la list box. Le code d'initialisation peut être placé dans l'événement fomulaire Sur chargement :
Au cas ou :(Evenement formulaire=Sur chargement) Form.eventList:=ds.Event.all() //retourne une sélection d'entités avec toutes les entités Fin de cas

Lorsque le formulaire est exécuté, la list box est automatiquement remplie avec la sélection d'entités :

Voir aussi

Self