WP INSERT DOCUMENT

4D v16

WP INSERT DOCUMENT


WP INSERT 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 INSERT 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 Get bookmark range ou WP Get range.

Le document inséré docWP peut être n'importe quel document 4D Write Pro, créé avec la commande WP New ou WP Import 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 Get selection(WPTemplate) //on lit la sélection utilisateur dans le document WPTemplate

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

 WP INSERT 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.

 ARRAY TEXT($_BookmarkNames;0)

 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames) //lire les signets du template

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

 

 $p:=Find in array($_BookmarkNames;"Main_Header") //traiter l'entête principal nommé "Main_Header"

 If($p>0)

    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) //sélectionner la plage

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

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

 End if

Voir aussi

WP INSERT BREAK
WP INSERT PICTURE
WP New