WP Get text

4D v20

WP Get text


WP Get text ( objCible {; expressions} ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
expressions	Numérique	Instructions pour l'évaluation de l'expression
Résultat	Texte	Texte de objCible

Description

La commande WP Get text récupère le contenu textuel d'un document 4D Write Pro dans l'objCible spécifié.

WP Get text renvoie uniquement du texte brut. Tous les styles appliqués (gras, italique, etc.) seront ignorés.

Dans le paramètre objCible, passez un objet contenant :

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

Notes :

Si vous passez un document 4D Write Pro objCible, la commande retourne uniquement le texte du corps du document.
Si vous passez une sous-section dans objCible, la commande retourne le texte de la section parente.

Le paramètre optionnel expressions fournit des instructions pour l'évaluation des expressions 4D dans l'objCible (pour plus d’informations, reportez-vous à la page Gérer des formules). Les options sont :

Constante	Comment
wk expressions as source	La chaîne d'origine des références des expressions 4D est retournée.
wk expressions as space	Chaque référence est retournée en tant qu'espace insécable.
wk expressions as value	Les références d'expressions 4D sont retournées dans leur forme évaluée (option par défaut).

Important : Seul le texte brut avec wk expressions as space est cohérent avec les index de plage de texte utilisés par les commandes WP ou ST, car ces commandes présument toujours que la taille de l'expression = 1 caractère.

Notes :

Si objCible contient des images, elles sont ignorées et renvoyées sous forme de caractères espaces (" ").
Si objCible contient des tableaux, le contenu de chaque cellule est traité comme des paragraphes individuels et renvoyé en tant que texte séparé par des tabulations. Les lignes sont séparées par des retours chariot.

Exemple

Pour retrouver le texte dans ce document :

Vous pouvez écrire :

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

 vText:=WP Get text($range;wk expressions as value) // retourne "Hello world! Today is: 06/03/18."

 vText2:=WP Get text($range;wk expressions as source) //retourne "Hello world! Today is: date du jour.

 vText3:=WP Get text($range;wk expressions as space) //retourne "Hello world! Today is:  ."

Voir aussi

Gérer des formules
WP SET TEXT