4D Doc Center : ch_INSERER VARIABLE

4D Chart v13

ch_INSERER VARIABLE


ch_INSERER VARIABLE ( zone ; cible ; premier ; dernier ; expression ; format )

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
cible	Entier long	-1 = Premier objet, 0 = Premier objet de la sélection, >0 = ID de l’objet
premier	Entier	Position du premier caractère moins 1
dernier	Entier	Position du dernier caractère
expression	Chaîne	Expression
format	Chaîne	Format de l’expression

Description

La commande ch_INSERER VARIABLE insère une référence à expression à l’intérieur de l’objet texte décrit par cible dans zone.

Si cible est égal à -1, la référence est insérée dans le premier objet du document.
Si cible est égal à 0, la référence est insérée dans le premier objet sélectionné.
Si cible est supérieur à 0, il doit être égal à l’identifiant de l’objet texte spécifique pour que la référence soit insérée dans ce dernier. Si l’objet n’existe pas, la commande est inopérante.

Si l’objet décrit par cible n’est pas un objet texte, la commande est inopérante.

premier et dernier déterminent l’endroit où la référence est insérée. premier est inférieur de un à la position du premier caractère à remplacer et dernier est la position du dernier caractère à remplacer. Si premier et dernier sont égaux, aucun caractère n’est remplacé et la référence est insérée entre premier et premier+1. Si dernier est supérieur au nombre de caractères dans l’objet texte, ch_INSERER VARIABLE remplace les caractères depuis premier jusqu’à la fin de l’objet texte.

expression est l’équivalent texte de toute expression 4D valide renvoyant une valeur. expression peut faire référence à l’un des éléments suivants : un champ, une variable, une fonction 4D, une fonction utilisateur (méthode projet), une fonction externe, ou une instruction.
Le tableau suivant fournit des exemples pour chaque type d’expression :

Exemple	Type
[Dessins]Objet	Champ
vCritère	Variable
Date du jour	Fonction 4D
ChercheNum	Fonction définie par l’utilisateur (méthode projet)
ch_Compter	Fonction 4D Chart
3 * "Hello"	Instruction

Le paramètre optionnel format est le format d’affichage de la référence. Cette option équivaut à choisir un format dans la boîte de dialogue Format. Vous pouvez faire référence aux formats par leur numéro ou leur nom. Les formats sont numérotés dans l’ordre où ils apparaissent dans la boîte de dialogue Format.

Si format est constitué d’un ou de deux caractères, le format appliqué à expression est tiré de la liste. Sinon il est comparé aux valeurs texte de chaque format de la liste. Si une valeur identique est trouvée, le format est appliqué. Par exemple, vous pouvez faire référence au premier format de date de deux façons : “19” ou “Court”.
Si format n’est pas dans la liste des formats, il est interprété comme étant un format numérique personnalisé. Si format ne convient pas à la valeur résultant de la référence, il est ignoré. Par exemple, si vous utilisez un format de date pour un nombre, ce dernier n’est pas formaté.

Exemple

L’exemple suivant crée un nouvel objet texte, le remplit avec une référence à la fonction 4D Date du jour et le formate en utilisant le format Date long.

 $ID :=ch_Creer texte(Zone;0.5;0.5;3.5;1;"Nous somme le : ")

 ch_INSERER VARIABLE(Zone;$ID;32000;32000;"Date du jour";"Long")