WP INSERT DOCUMENT

4D v20 R7

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( objCible ; docWP ; mode {; miseAJourPlage} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
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 objCible selon le mode d'insertion spécifié et le paramètre miseAJourPlage.

Dans objCible, passez :

une plage, ou
un élément (tableau / ligne / paragraphe / corps / en-tête / pied / image en ligne / section / sous-section / zone de texte), ou
un document 4D Write Pro.

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 (i.e. les en-têtes, pieds, zones de texte et images ancrées ne sont pas insérés). Les sections et signets de 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 plusieurs 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 objCible du document de destination :

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

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

Constante	Type	Valeur	Comment
wk freeze expressions	Entier long	64	Fige les expressions lors de l'insertion
wk keep paragraph styles	Entier long	128	Conserver les styles du paragraphe de destination

Si objCible est une plage, vous pouvez utiliser le paramètre optionnel miseAJourPlage pour passer une des constantes suivantes et indiquer si le contenu inséré est inclus ou pas dans la plage résultante :

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.

Si objCible n'est pas une plage, miseAJourPlage est ignoré.

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

Download HDI database
WP INSERT BREAK
WP INSERT PICTURE
WP New