version 6.7 (Modifiée)
WR LIRE REFERENCE (zone; info1; info2; nom; type{; formatNum{; formatDate{; formatHeure}}})
| Paramètre | Type | Description | |
| zone | Entier long | 4D Write area | |
| info1 | Entier | Première information relative à la référence | |
| info2 | Entier | Deuxième information relative à la référence | |
| nom | Alpha | Nom de la référence | |
| type | Entier | Type de la référence | |
| formatNum | Alpha | Format d'affichage numérique | |
| formatDate | Entier | Numéro du format de la date | |
| formatHeure | Entier | Numéro du format de l'heure |
Description
Est appelée "référence" toute commande 4D, variable 4D ou référence à un champ insérée dans une zone 4D Write.
La commande WR LIRE REFERENCE retourne dans type le type de la référence sélectionnée (voir à ce propos la description de la routine WR SELECTIONNER), et dans info1, info2 et nom diverses informations concernant la référence (ces informations dépendent de la valeur de type).
Vous pouvez également connaître le format d'affichage des références de type numérique, Date ou Heure insérées.
Si type est égal à 1, vous êtes en présence d'une référence de type champ.
Dans ce cas, info1 désignera la table à laquelle appartient le champ, info2 désignera le champ et nom sera vide.
Si type est égal à 2, vous êtes en présence d'une référence de type variable ou d'une expression. Dans ce cas, info1 et info2 prendront pour valeur 0, et nom contiendra le nom de la variable ou de l'expression.
Si l'objet sélectionné n'est pas une référence, type retourne 0.
Le paramètre formatNum retourne une chaîne contenant le format numérique associé à l'expression numérique (Numérique, Entier ou Entier long) sélectionnée. Si aucun format n'est associé à l'expression ou si elle n'est pas de type numérique, une chaîne vide est retournée.
Le paramètre formatDate retourne le numéro du format de date éventuellement associé à l'expression sélectionnée, si elle est de type date. Dans le cas contraire, la valeur 0 est retournée.
Voici les codes de formatage pour les dates :
| Format de date | Nom | Numéro |
| 6/01/00 | (court) | 1 |
| Jeu 6 Jan 2000 | (abrégé) | 2 |
| Jeudi 6 Janvier 2000 | (long) | 3 |
| 06/01/2000 | (spécial) | 4 |
| 6 Janvier 2000 | (jour mois année) | 5 |
| 6 Jan 2000 | (abrégé jour mois année) | 6 |
| 06/01/2000 | (spécial forcé) | 7 |
Le paramètre formatHeure retourne le numéro du format d'heure éventuellement associé à l'expression sélectionnée, si elle est de type heure. Dans le cas contraire, la valeur 0 est retournée. Voici les codes de formatage pour les heures :
| Format d'heure | Valeur |
| h:mm:ss | 1 |
| h:mm | 2 |
| h heures mm minutes ss secondes | 3 |
| h heures mm minutes | 4 |
| h:mm matin après midi | 5 |
Exemples
(1) Reportez-vous à l'exemple de la routine WR SELECTIONNER.
(2) Cette méthode indique si l'objet sélectionné par l'utilisateur est une référence, ainsi que son type :
WR LIRE REFERENCE (Lettre;$Table;$Champ;$Nom;$Type)
Au cas ou
: ($Type=0) `Pas de référence
ALERTE("La sélection ne contient pas de référence.")
: ($Type=1)
ALERTE("La sélection contient le champ "+Nom du champ($Table;$Nom))
: ($Type=2)
ALERTE("La sélection contient l'expression nommée "+$Name)
Fin de cas
Référence
WR INSERER CHAMP, WR INSERER VARIABLE.