|
|
|
|
|
|
|
|
|
version 6.0
dr_INSERER VARIABLE (zone; cible; premier; dernier; expression{; format})
| Paramètre | Type | Description | |
| zone | Entier long |  | Zone 4D Draw |
| cible | Entier long | | -1 = Objet placé au dernier plan, |
| 0 = Objet placé au dernier plan de la sélection, | |||
| >0 = ID | |||
| premier | Entier | | Position du premier caractère -1 |
| dernier | Entier | | Position du dernier caractère |
| expression | Alpha | | Expression à insérer |
| format | Alpha | | Formatage à appliquer |
Description
La commande dr_INSERER VARIABLE insère dans l'objet de type Texte désigné par cible la référence à l'expression passée en cinquième paramètre.
• Si cible est égal à -1, dr_INSERER VARIABLE insère la référence à l'expression dans l'objet placé au premier plan. Si les plans n'ont pas été modifiés, ce numéro correspond au premier objet créé dans zone.
• Si cible est égal à 0, dr_INSERER VARIABLE considère la sélection courante et insère la référence à l'expression dans l'objet placé sur le plan le plus éloigné de la sélection.
• Si cible est supérieur à 0, dr_INSERER VARIABLE interprète la valeur passée comme étant le numéro d'identification d'un objet et insère, dans l'objet désigné, la référence à l'expression. Si l'objet n'est pas de type Texte, dr_INSERER VARIABLE ne fait rien et dr_Erreur renvoie une erreur n°47. Si l'objet n'existe pas, dr_INSERER VARIABLE ne fait rien et dr_Erreur retourne une erreur n°2.
Si l'objet désigné par cible n'est pas de type Texte, dr_INSERER VARIABLE ne fait rien.
premier et dernier déterminent l'endroit où sera insérée la référence à l'expression. La référence sera insérée entre deux bornes et remplacera les caractères placés entre. premier indique la première borne, soit la position du premier caractère -1. dernier indique la seconde borne.
• Si premier et dernier sont égaux, aucun caractère ne sera remplacé et l'insertion se fera entre premier et premier +1.
• Si dernier est supérieur au nombre de caractères admis par un objet de type Texte soit 32 000, le contenu de l'objet désigné par cible sera intégralement remplacé par la référence à l'expression.
expression accepte tout type d'expression admis par 4e Dimension : une variable, une fonction, une méthode projet, une fonction externe, un résultat.
| Exemple | Type |
| vN | Variable |
| Date | Fonction 4e Dimension |
| MéthEvenement | Méthode projet |
| dr_Compter | Fonction externe |
| 3*"Bonjour" | Résultat |
format indique le formatage qui devra être appliqué lorsque le contenu de l'expression sera affiché. Ce paramètre est l'équivalent par programmation de la commande Format… du menu Base.
Les formats sont identifiés soit par la chaîne qui les caractérise, soit par leur ordre d'apparition dans la liste. Si le format n'est pas adapté au type de l'expression, le format sera ignoré. Ce paramètre est optionnel et peut donc être omis.
Exemple
L'exemple suivant crée un objet de type Texte, insère la date courante et lui applique le format Long.
$ID:=dr_Creer texte (LaZone;0,5;0,5;10;1;"A Paris le ") dr_INSERER VARIABLE (LaZone;$ID;32000;32000;"Date du jour";"Long")
Référence
|
|
|
|
|
|
|
|
|