WP Plage texte

4D v20 R7

WP Plage texte


WP Plage texte ( objCible ; débutPlage ; finPlage ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
débutPlage	Entier long	Position du début de la plage dans la zone
finPlage	Entier long	Position de la fin de la plage dans la zone
Résultat	Objet	Nouvel objet plage

Compatibilité

La commande WP Plage texte était nommée WP Creer plage dans les versions précédentes de 4D Write Pro. Elle a été renommée pour plus de clarté.

Description

La commande WP Plage texte retourne une nouvelle plage contenant les caractères situés entre débutPlage et finPlage dans l'objet objCible.

Un objet plage 4D Write Pro peut être utilisé pour manipuler des attributs sur une partie du document (notamment à l'aide des commandes WP LIRE ATTRIBUTS et WP FIXER ATTRIBUTS). Pour plus d'informations, veuillez vous reporter au paragraphe Gestion des plages.

Dans objCible, vous pouvez passer :

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

Si un objet non valide est passé dans objCible, une plage vide est retournée.

Dans débutPlage et finPlage, passez des valeurs correspondant à la position du premier et du dernier caractère à sélectionner pour la plage. Vous pouvez passer wk start text dans débutPlage pour désigner le début du document et wk end text dans finPlage pour désigner la fin du document. N'oubliez pas qu'un document 4D Write Pro ne contient pas seulement du texte visible mais également des caractères de formatage et des balises qui sont inclus dans la plage.

Note : Si vous avez passé une référence d'élément tableau, ligne, paragraphe, image en ligne, body, en-tête, pied, section ou sous-section dans objCible, les valeurs débutPlage et finPlage seront relatives aux indices de début et de fin de la plage de l'élément. Par exemple, si un en-tête est passé, wk start text désigne le caractère de début de l'en-tête et wk end text le dernier caractère de l'en-tête ; si une référence d'élément tableau est passée, la commande retourne la plage de texte relative au tableau référencé. Si une section est passée, débutPlage et finPlage sont relatives au corps du document (zone parente d'une plage créée à partir d'une section). Voir l'exemple 2 ci-dessous.

Exemple 1

Vous souhaitez sélectionner une plage de 12 caractères à partir du début d'un champ 4D Write Pro. Le champ est affiché dans un objet de formulaire :

Si vous exécutez :

 $range2:=WP Plage texte([SAMPLE]WP;wk start text;12)

 WP SELECTIONNER(*;"WParea";$range2)

... le résultat est le suivant :

Exemple 2

Vous voulez créer une plage à partir d'une section :

 C_OBJET($wpRange)

 $wpRange:=WP Plage texte(wpSection;1;11) //retourne une plage créée à partir des 10 premiers caractères de la section

  //si la section commence à 100 dans le document :

  //$wpRange.start = 100

  //$wpRange.end = 111

Voir aussi

WP Lire corps
WP Lire entete
WP Plage images
WP Plage paragraphes
WP Plage selection
WP Plage signet
WP Plage tableaux
WP SELECTIONNER