4D v17

WP SET TEXT

Accueil

 
4D v17
WP SET TEXT

WP SET TEXT 


 

WP SET TEXT ( objPlage ; nouveauTexte ; positionTexte {; miseAJourPlage} )  
Paramètre Type   Description
objPlage  Objet in Plage 4D Write
nouveauTexte  Texte in Texte à insérer
positionTexte  Numérique in Position de l'insertion (remplace, avant, après)
miseAJourPlage  Numérique in Inclut ou exclut le contenu inséré dans la plage

La commande WP SET TEXT insère le texte passé dans le paramètre nouveauTexte en texte brut dans un document 4D Write Pro, à la position spécifiée par les paramètres objPlage and positionTexte.

Dans le paramètre objPlage, passezun 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.

Le paramètre nouveauTexte contient le texte à insérer dans objPlage. 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ée 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

Dans le paramètre optionnel miseAJourPlage, vous pouvez passer une des constantes suivantes pour préciser si le texte 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)

Exemple  

Vous souhaitez ajouter du texte à ce document :

Avant le texte existant :

 $range:=WP Create 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 Create 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 Create range(myDoc;wk start text;wk end text)
 WP SET TEXT($range;" Hello world!";wk replace)
  // écrit " Hello world!"



Voir aussi  

WP Get text

 
PROPRIÉTÉS 

Produit : 4D
Thème : 4D Write Pro - Langage
Numéro : 1574

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

New
Créé : 4D v17

 
UTILISATION DE L'ARTICLE

4D Write Pro ( 4D v17)