OBJET Lire formatage

4D v16.3


OBJET Lire formatage ( {* ;} objet ) -> Résultat

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 (si * spécifié) ou Champ ou variable (si * omis)
Résultat	Chaîne	Format d’affichage de l’objet

Description

La commande OBJET Lire formatage retourne le format d’affichage courant appliqué à l’objet spécifié par le paramètre objet.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (dans ce cas, passez une chaîne dans objet). 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.

Cette commande retourne le format d’affichage courant de l’objet, c’est-à-dire le format défini en mode Développement ou à l’aide de la commande OBJET FIXER FORMATAGE. OBJET Lire formatage fonctionne avec tous les types d’objets de formulaire (champs ou variables) acceptant un format d’affichage : booléen, date, heure, image, chaîne, numérique, ainsi que les grilles de boutons, cadrans, thermomètres, règles, pop up menus image, boutons image, boutons 3D et en-têtes de list box. Pour plus d’informations sur les formats d’affichage de ces objets, reportez-vous à la documentation de la commande OBJET FIXER FORMATAGE.

Note : Si vous appliquez la commande à un ensemble d’objets, seul le formatage du dernier objet pris en compte est retourné.

Lorsque la commande OBJET Lire formatage est appliquée à des objets de type date, heure ou image (formats définis sous forme de constantes), la chaîne retournée correspond au code de caractere de la constante. Pour obtenir la valeur de la constante, il suffit d’appliquer la fonction Code de caractere au résultat (cf. exemple ci-dessous).

Exemple 1

Cet exemple permet d’obtenir la valeur de la constante de formatage appliquée à la variable image dont le nom d’objet est “maphoto” :

 C_ALPHA(2;$format)

 OBJET FIXER FORMATAGE(*;"maphoto";Caractere(Sur fond))

  `Application du format sur fond (valeur = 3)

 $format:=OBJET Lire formatage(*;"maphoto")

 ALERTE("Format numéro :"+Chaine(Code de caractere($format)))

  `Affichage de la valeur "3"

Exemple 2

Cet exemple permet d’obtenir le formatage appliqué au champ booléen [Adhérents]Etat_civil :

 C_ALPHA(30;$format)

 $format:=OBJET Lire formatage([Adhérents]Etat_civil)

 ALERTE($format) `Affichage du format, par exemple "Marié;Célibataire"

Voir aussi

OBJET FIXER FORMATAGE