4D Doc Center : WR INSERER VARIABLE

4D Write v14

WR INSERER VARIABLE


WR INSERER VARIABLE ( zone ; expression {; formatNum {; formatDate {; formatHeure {; destination {; taille}}}}} )

Paramètre	Type	Description
zone	Entier long	Zone 4D Write
expression	Chaîne	Expression à insérer
formatNum	Chaîne	Format d’affichage numérique
formatDate	Entier	Numéro du format de la date
formatHeure	Entier	Numéro du format de l’heure
destination	Entier long	Endroit où l'image sera placée
taille	Entier long	0=Taille fixe, 1=Taille ajustée

Description

La commande WR INSERER VARIABLE insère une expression dans zone à l’emplacement du curseur ou à la place de la sélection courante.

expression peut être une variable, une fonction, une méthode projet, une routine externe ou toute expression qui retourne une valeur. expression peut également être une variable image. Si expression est une variable, vous devez passer son nom comme argument, encadré par des guillemets ("").
expression peut contenir des retours à la ligne et des tabulations, ils seront pris en compte par 4D Write. L’expression ainsi insérée répondra aux caractéristiques de la règle dont elle dépend.

Le paramètre optionnel formatNum indique le formatage des expressions numériques (de type Numérique, Entier ou Entier long). Il peut contenir tout format d’affichage numérique, existant ou non (par exemple "###,##"). Passez une chaîne vide lorsque ce paramètre n’est pas approprié ou omettez-le si les deux paramètres suivants sont omis.

Le paramètre optionnel formatDate indique le formatage des expressions de type Date. Il doit contenir un numéro de format de date existant. Passez 0 lorsque ce paramètre n’est pas approprié ou omettez-le si le paramètre suivant est omis. Sinon, utilisez les constantes 4D suivantes, placées dans le thème "Formats d'affichage des dates" de 4D et le thème "WR Paramètres" de 4D Write :

Constante	Type	Valeur	Commentaire
Système date court	Entier long	1	06/12/2006
Système date abrégé	Entier long	2	mer. 25 déc. 2006
Système date long	Entier long	3	mercredi 6 décembre 2006
Interne date court spécial	Entier long	4	06/12/06 (mais 06/12/1896 ou 06/12/2096)
Interne date long	Entier long	5	6 décembre 2006
Interne date abrégé	Entier long	6	6 déc 1996
Interne date court	Entier long	7	06/12/2006

Constante	Type	Valeur	Commentaire
wr pas de format date	Entier long	0	Pas de format date.

Le paramètre optionnel formatHeure indique le formatage des expressions de type Heure. Il doit contenir un numéro de format d’heure existant. Passez 0 lorsque ce paramètre n’est pas approprié ou omettez-le. Sinon, utilisez les constantes 4D suivantes, placées dans le thème "Formats d'affichage des heures" de 4D et le thème "WR Paramètres" de 4D Write.

Constante	Type	Valeur	Commentaire
h mn s	Entier long	1	01:02:03
h mn	Entier long	2	01:02
Heures minutes secondes	Entier long	3	1 heure 2 minutes 3 secondes
Heures minutes	Entier long	4	1 heure 2 minutes
h mn Matin Après Midi	Entier long	5	1:02 du matin

Constante	Type	Valeur	Commentaire
wr pas de format heure	Entier long	0	Pas de format heure.

Lorsque vous insérez une expression image, le paramètre optionnel destination permet d'indiquer à quel emplacement du document l'image doit être insérée. Vous pouvez utiliser toute valeur >0 ou l'une des constantes suivantes, placées dans le thème "WR Paramètres" :

Constante	Type	Valeur	Commentaire
wr dans les pages gauches	Entier long	-12	L’image sera insérée dans la page et sera affichée dans les pages gauches uniquement si les en-têtes pairs et impairs sont différents.
wr dans les pages droites	Entier long	-11	L’image sera insérée dans la page et sera affichée dans les pages droites si les en-têtes pairs et impairs sont différents, et sinon dans toutes les pages.
wr dans la page courante	Entier long	-4	L’image sera insérée dans la page et visible sur la page courante (celle qui contient le curseur ou la sélection courante).
wr dans le corps du texte	Entier long	0	L'image sera insérée dans le corps du texte. Dans ce cas, les autres paramètres ne seront pas utilisés et l'image sera placée à l’emplacement du curseur ou à la place de la sélection courante.

Toute valeur >0

L’image sera visible sur la page de numéro destination. La valeur doit tenir compte du début de numérotation.

Dans le contexte de l'ajout d'une expression image, le paramètre optionnel taille permet de définir si le rectangle d'affichage sera gardé ou ajusté :

Si vous passez 1 dans taille, lors du calcul de l’expression, le rectangle d’affichage sera ajusté aux nouvelles dimensions de l’image.
Si vous passez 0 dans taille, lors du calcul de l’expression, le rectangle d’affichage sera conservé, quelle que soit la dimension de la nouvelle image.

Exemple

Vous voulez insérer une variable contenant la liste des factures restant à régler.

 Tab:=Caractere(Tabulation)

 CR:=Caractere(Retour chariot) `Cherchons les factures du client

 CHERCHER([Fact];[Fact]CodeClient=[Clients]CodeClient;*)

 CHERCHER([Fact];&[Fact]Reglé=Faux) `Cherchons les factures non soldées

 vARegler:="" `Initialisons la variable

 Boucle(CompteFact;1;Enregistrements trouves([Fact])) `Pour tous les enregistrements

    vARegler:=vARegler+Chaine([Fact]No)+Tab `Ajoutons le n° de facture

    vARegler:=vARegler+[Fact]Montant+CR `Ajoutons le montant à régler

    ENREGISTREMENT SUIVANT([Fact]) `Passons à l’enregistrement suivant

 Fin de boucle

 WR INSERER VARIABLE(LeTexte;"vARegler") `Insérons dans le texte la variable vARegler