dr_INSERER CHAMP

version 6.0

dr_INSERER CHAMP (zone; cible; premier; dernier; table; champ{; format})

Paramètre	Type		Description
zone	Entier long		Zone 4D Draw
cible	Entier long		-1 = Objet placé au premier 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
table	Entier		Numéro de table
champ	Entier		Numéro du champ
format	Alpha		Formatage à appliquer

La commande dr_INSERER CHAMP insère une référence au champ dans un objet de type Texte désigné par cible.

• Si cible est égal à -1, dr_INSERER CHAMP insère la référence au champ 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 CHAMP considère la sélection courante et insère la référence au champ dans l'objet placé au dernier plan de la sélection.

• Si cible est supérieur à 0, dr_INSERER CHAMP 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 au champ. Si l'objet n'est pas de type Texte, dr_INSERER CHAMP ne fait rien et dr_Erreur renvoie une erreur n°47. Si l'objet n'existe pas, dr_INSERER CHAMP ne fait rien et dr_Erreur retourne une erreur n°2.

Si l'objet cible n'est pas de type Texte, dr_INSERER CHAMP ne fait rien.

premier et dernier déterminent l'endroit où sera insérée la référence au champ. La référence sera insérée entre deux bornes et remplacera les caractères placés dans l'intervalle. 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 au champ.

table et champ déterminent le champ qui sera référencé. Tables et champs sont numérotés en fonction de leur ordre de création.

format indique le formatage qui devra être appliqué lorsque le contenu du champ 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 de caractères qui les caractérise, soit par leur ordre d'apparition dans la liste. Si le format n'est pas adapté au type de champ, le format sera ignoré. Ce paramètre est optionnel et peut donc être omis.

L'exemple suivant remplace le texte de l'objet dont le numéro d'identification est 1 par la référence au premier champ de la première table. Le format qui sera appliqué à ce champ sera le onzième.

   dr_INSERER CHAMP (LaZone;1;0;32000;1;1;"11")

dr_INSERER VARIABLE.