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. Sinon, vous pouvez comparer la valeur reçue aux constantes 4D suivantes, placées dans le thème "Formats d'affichage des dates" :
Format de date | Constante (valeur) |
6/01/00 | Système date court (1) |
jeu 6 jan 2000 | Système date abrégé (2) |
jeudi 6 janvier 2000 | Système date long (3) |
06/01/2000 | Interne date court spécial (4) |
6 janvier 2000 | Interne date long (5) |
6 jan 2000 | Interne date abrégé (6) |
06/01/2000 | Interne date court (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. Sinon, vous pouvez comparer la valeur reçue aux constantes 4D suivantes, placées dans le thème "Formats d'affichage des heures" :
Format d'heure | Constante (valeur) |
h:mm:ss | h mn s (1) |
h:mm | h mn (2) |
h heures mm minutes ss secondes | Heures Minutes Secondes (3) |
h heures mm minutes | Heures Minutes (4) |
h:mm matin après midi | h mn 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.