4D v17
WP Create range
- 4D Write Pro
-
- 4D Write Pro - Langage
-
- A propos des objets 4D Write Pro
- Utiliser les commandes du thème Objets (Formulaires)
- Utiliser les commandes du thème Texte multistyle
- Accéder au contenu des documents par programmation
- Constantes 4D Write Pro
- WP Add picture
- WP CREATE BOOKMARK
- WP Create paragraph range
- WP Create picture range
- WP Create range
- WP Create table rangeNew
- WP DELETE BOOKMARK
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP Get bookmark range
- WP GET BOOKMARKS
- WP Get element by IDNew
- WP Get elementsNew
- WP Get footer
- WP Get frame
- WP Get header
- WP Get page count
- WP Get positionNew
- WP Get selection
- WP Get textNew
- WP Import document
- WP INSERT BREAKMod
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET TEXTNew
- WP Table append row
- WP Table get cellsMod
- WP Table get columnsMod
- WP Table get rowsMod
- WP USE PAGE SETUP
- Attributs 4D Write Pro
WP Create range
| WP Create range ( objCible ; débutPlage ; finPlage ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| objCible | Objet |
|
Plage ou référence d'é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 | |||||
La commande WP Create range était nommée WP Lire plage dans les versions précédentes de 4D Write Pro. Elle a été renommée pour plus de clarté.
La commande WP Create range retourne une nouvelle plage (objPlage) 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 GET ATTRIBUTES et WP SET ATTRIBUTES). Pour plus d'informations, veuillez vous reporter au paragraphe Gestion des plages.
Dans objCible, vous pouvez passer :
- un objet plage 4D Write Pro, ou
- une référence d'élément (en-tête / pied / corps / tableau / ligne / image en ligne / paragraphe), ou
- un document 4D Write Pro.
Si un objet non valide est passé dans objCible, une plage objPlage 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.
Si vous avez passé une référence d'élément tableau, ligne, paragraphe, image en ligne, body, en-tête ou pied 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é.
Note : Si vous avez passé une référence d'élément dans objCible, la plage retournée est relative au contenu de l'élément parent. L'objet plage conserve une référence interne à l'objet parent (en-tête, pied, corps, tableau, etc).
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 Create range([SAMPLE]WP;wk start text;12)
WP SELECT(*;"WParea";$range2)... le résultat est le suivant :
WP Get body
WP Get bookmark range
WP Get header
WP Get selection
WP SELECT
Produit : 4D
Thème : 4D Write Pro - Langage
Numéro :
1341
Créé : 4D v15 R4
Modifié : 4D v16 R5
Renommé : 4D v16 R5
4D Write Pro ( 4D v17)
