4D v16

WP Get range

Accueil

 
4D v16
WP Get range

WP Get range 


 

WP Get range ( zoneWP ; débutPlage ; finPlage ) -> Résultat 
Paramètre Type   Description
zoneWP  Objet in Champ ou variable objet 4D Write Pro
débutPlage  Entier long in Position du début de la plage dans la zone
finPlage  Entier long in Position de la fin de la plage dans la zone
Résultat  Objet in Nouvel objet plage

La commande WP Get range retourne une nouvelle plage de sélection (objPlage) contenant les caractères situés entre débutPlage et finPlage dans la zone 4D Write Pro zoneWP.

Passez un champ objet ou une variable objet 4D Write Pro dans wpArea. Si une zone 4D Write Pro non valide est passée, une plage objRange 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.

La commande retourne un nouvel objet de type objPlage. Un objPlage est un objet plage 4D Write Pro qui peut être utilisé pour manipuler des attributs sur une partie du document (à l'aide des commandes WP GET ATTRIBUTES et WP SET ATTRIBUTES). Il contient trois attributs privés en lecture seule (wk range start, wk range end et wk range owner) qui définissent la plage elle-même.

Exemple  

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 Get range([SAMPLE]WP;wk start text;12)
 WP SELECT(*;"WParea";$range2)

... le résultat est le suivant :



Voir aussi  

WP Get selection
WP SELECT

 
PROPRIÉTÉS 

Produit : 4D
Thème : 4D Write Pro - Langage

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

 
HISTORIQUE 

Créé : 4D v15 R4

 
UTILISATION DE L'ARTICLE

4D Write Pro ( 4D v16)