OBJECT Get format

4D v16.3

OBJECT Get format


OBJECT Get format ( {* ;} 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 OBJECT Get format 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 OBJECT SET FORMAT. OBJECT Get format 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 OBJECT SET FORMAT.

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

Lorsque la commande OBJECT Get format 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 Character code 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_STRING(2;$format)

 OBJECT SET FORMAT(*;"maphoto";Char(On background))

  `Application du format sur fond (valeur = 3)

 $format:=OBJECT Get format(*;"maphoto")

 ALERT("Format numéro :"+String(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_STRING(30;$format)

 $format:=OBJECT Get format([Adhérents]Etat_civil)

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

Voir aussi

OBJECT SET FORMAT