WP INSERER DOCUMENT

4D v16

WP INSERER DOCUMENT


WP INSERER DOCUMENT ( objPlage ; docWP ; mode {; miseAJourPlage} )

Paramètre	Type	Description
objPlage	Objet	Plage 4D Write Pro cible
docWP	Objet	Document 4D Write Pro à insérer
mode	Entier long	Mode d'insertion
miseAJourPlage	Entier long	Mode de mise à jour de la plage de sélection

Description

La commande WP INSERER DOCUMENT insère le document docWP dans la plage objPlage selon le mode d'insertion spécifié et le paramètre miseAJourPlage.

Dans objPlage, passez une plage de sélection 4D Write Pro valide. Une plage de sélection objPlage est une partie d'un document 4D Write Pro ; elle peut être créée en utilisant la commande , WP Lire plage signet ou WP Lire plage.

Le document inséré docWP peut être n'importe quel document 4D Write Pro, créé avec la commande WP Nouveau ou WP Importer document. Seuls les éléments du corps du texte sont insérés (sections et signets dans la plage de destination sont préservés). De plus, les éléments sont copiés, ainsi docWP peut être ré-utilisé plusieurs fois.

Dans le paramètre mode, passez une ou une combinaison des constantes suivantes du thème Constantes 4D Write Pro, pour indiquer le mode d'insertion à utiliser pour le document dans la plage de sélection objPlage du document de destination :

Constante	Type	Valeur	Comment
wk append	Entier long	2	Insère le contenu à la fin de la plage
wk prepend	Entier long	1	Le contenu est inséré au début de la plage
wk replace	Entier long	0	Remplace le contenu de la plage

Vous pouvez combiner une des constantes ci-dessus avec les options d'insertion suivantes :

Constante	Type	Valeur	Comment
wk freeze expressions	Entier long	64	Figer les expressions lors de l'insertion
wk inherit style from paragraph	Entier long	32	Le contenu inséré hérite des styles de caractères par défaut du paragraphe.
wk keep paragraph styles	Entier long	128	Conserver les styles du paragraphe de destination

Dans le paramètre optionnel miseAJourPlage, vous pouvez passer une des constantes suivantes pour spécifier si le contenu inséré est inclus ou pas dans la plage mise à jour :

Constante	Type	Valeur	Comment
wk exclude from range	Entier long	1	Le contenu inséré n'est pas inclus dans la plage mise à jour
wk include in range	Entier long	0	Le contenu inséré est inclus dans la plage mise à jour (défaut)

Si vous ne passez pas le paramètre miseAJourPlage, par défaut, le contenu inséré sera inclus dans la plage de sélection résultante.

Exemple 1

Vous souhaitez remplacer le contenu d'un document par le texte sélectionné d'un autre document :

 $tempRange:=WP Lire selection(WPTemplate) //on lit la sélection utilisateur dans le document WPTemplate

 $doctoCopy:=WP Nouveau($tempRange) //on crée un nouveau document à partir de WPTemplate

 WP INSERER DOCUMENT(WPDoc;$doctoCopy;wk replace) //on remplace le contenu de WPDoc par le contenu du nouveau document

Exemple 2

Vous avez défini un document modèle (template) comportant différentes parties préformatées, chacune d'elles étant stockée en tant que signet. Lorsque vous produisez un document final à partir du template, vous pouvez traiter chaque signet en tant que nouveau document et l'insérer dans le document final.

 TABLEAU TEXTE($_BookmarkNames;0)

 WP LIRE SIGNETS([TEMPLATES]WP;$_BookmarkNames) //lire les signets du template

 $targetRange:=WP Nouveau //créer un nouveau document vide (sera le document final)

 

 $p:=Chercher dans tableau($_BookmarkNames;"Main_Header") //traiter l'entête principal nommé "Main_Header"

 Si($p>0)

    $Range:=WP Lire plage signet(WParea;$_BookmarkNames{$p}) //sélectionner la plage

    $RangeDoc:=WP Nouveau($Range) //créer un nouveau document depuis la plage

    WP INSERER DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) //wk append=après remplacement, $buildRange est égal à la fin du texte remplacé

 Fin de si

Voir aussi

WP INSERER IMAGE
WP INSERER RUPTURE
WP Nouveau