WP SET TEXT

4D v20 R7

WP SET TEXT


WP SET TEXT ( objCible ; nouveauTexte ; positionTexte {; miseAJourPlage} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
nouveauTexte	Texte	Texte à insérer
positionTexte	Numérique	Position de l'insertion (remplace, avant, après)
miseAJourPlage	Numérique	Inclut ou exclut le contenu inséré dans la plage

Description

La commande WP SET TEXT insère le texte passé dans le paramètre nouveauTexte en texte brut dans le paramètre objCible à la position spécifiée par le paramètre positionTexte.

Dans le paramètre objCible, passez un objet plage pour désigner la position où le texte doit être inséré. La plage peut être un emplacement explicite dans le document 4D Write Pro ou peut être basée sur une sélection de l'utilisateur. Vous pouvez passer :

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

Le paramètre nouveauTexte contient le texte à insérer dans objCible. WP SET TEXT insère du texte brut seulement, tel qu'il est écrit, mais sans aucune balise de style.

Dans le paramètre positionTexte, l'emplacement du texte inséré peut être précisé en passant l'un des sélecteurs suivants :

Constante	Comment
wk append	Insère le contenu à la fin de la cible
wk prepend	Le contenu est inséré au début de la cible
wk replace	Remplace le contenu de la cible

Si objCible est une plage, vous pouvez utiliser le paramètre optionnel miseAJourPlage pour passer une des constantes suivantes pour préciser si le contenu inséré doit être inclus ou non dans la plage résultante :

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

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

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

Exemple

Vous souhaitez ajouter du texte à ce document :

objCible est un document 4D Write Pro :

 WP SET TEXT(myDoc;"Hello world";wk append)

 /écrit"The quick brown fox jumps over the lazy dog. Hello world!"

objCible est une plage :

Avant le texte existant :

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk prepend) 

  // écrit " Hello world! The quick brown fox jumps over the lazy dog."

Après le texte existant :

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk append) 

  // écrit "The quick brown fox jumps over the lazy dog. Hello world!"

Remplace le texte existant :

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk replace) 

  // écrit " Hello world!"

Voir aussi

WP Get text