ch_INSERER VARIABLE

4D - Documentation   Français   English   German   4D Chart, Commandes par thème   4D Chart, Liste alphabétique des commandes   Retour   Précédent   Suivant

version 1


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

ParamètreTypeDescription
zoneEntier longZone 4D Chart
cibleEntier long-1 = Premier objet, 0 = Premier objet de la sélection,
>0 = ID de l'objet
premierEntierPosition du premier caractère moins 1
dernierEntierPosition du dernier caractère
expressionAlphaExpression
formatAlphaFormat 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 4e Dimension valide renvoyant une valeur. expression peut faire référence à l'un des éléments suivants : un champ, une variable, une fonction 4e Dimension, une fonction utilisateur (méthode projet), une fonction externe, ou une instruction.

Le tableau suivant fournit des exemples pour chaque type d'expression :

ExempleType
[Dessins]ObjetChamp
vCritèreVariable
Date du jourFonction 4e Dimension
ChercheNumFonction définie par l'utilisateur (méthode projet)
ch_CompterFonction 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 4e Dimension 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")

Référence

ch_INSERER CHAMP.


4D - Documentation   Français   English   German   4D Chart, Commandes par thème   4D Chart, Liste alphabétique des commandes   Retour   Précédent   Suivant