OBJECT Get placeholder
OBJECT Get placeholder ( {* ;} objet ) : Text
| 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 | any | → | Nom d'objet (si * est spécifié) ou Champ ou variable (si * est omis) |
| Résultat | Text | ← | Texte d’exemple associé à l’objet |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande OBJECT Get placeholder retourne le texte d’exemple associé à l’objet ou aux objets désigné(s) par les paramètres objet et *. Si aucun texte d’exemple n’est associé à l’objet, la commande retourne une chaîne vide.
Un texte d’exemple peut avoir été défini soit via la Liste des propriétés, soit via la commande OBJECT SET PLACEHOLDER.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). 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 (champ ou variable objet uniquement).
Si le texte d’exemple est une référence xliff définie via la Liste des propriétés, la commande retourne la référence d’origine sous la forme ":xliff:resname" et non sa valeur calculée.
Exemple
Vous souhaitez lire le texte exemple d’un champ :
$txt:=OBJECT Get placeholder([Personnes]Nom)