4D v18
WP Text 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 Bookmark range
- WP DELETE BOOKMARK
- WP DELETE FOOTER
- WP DELETE HEADER
- WP DELETE STYLE SHEETNew
- WP DELETE SUBSECTION
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP GET BOOKMARKS
- WP Get element by ID
- WP Get elements
- WP Get footer
- WP Get frame
- WP Get header
- WP Get links
- WP Get page count
- WP Get position
- WP Get section
- WP Get sections
- WP Get style sheetNew
- WP Get style sheetsNew
- WP Get subsection
- WP Get text
- WP Get view properties
- WP Import document
- WP IMPORT STYLE SHEETSNew
- WP INSERT BREAK
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP NEW BOOKMARK
- WP New footer
- WP New header
- WP New style sheetNew
- WP New subsection
- WP Paragraph range
- WP Picture range
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP Selection range
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET LINK
- WP SET TEXT
- WP SET VIEW PROPERTIES
- WP Table append row
- WP TABLE DELETE COLUMNSNew
- WP TABLE DELETE ROWSNew
- WP Table get cellsMod
- WP Table get columnsMod
- WP Table get rowsMod
- WP Table insert columnsNew
- WP Table insert rowsNew
- WP Table range
- WP Text range
- WP USE PAGE SETUP
- Attributs 4D Write Pro
WP Text range
| WP Text range ( 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 | |||||
La commande WP Text range était nommée WP Create range dans les versions précédentes de 4D Write Pro. Elle a été renommée pour plus de clarté.
La commande WP Text range 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 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
- 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.
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 Text range([SAMPLE]WP;wk start text;12)
WP SELECT(*;"WParea";$range2)... le résultat est le suivant :
Vous voulez créer une plage à partir d'une section :
C_OBJECT($wpRange)
$wpRange:=WP Text range(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
WP Bookmark range
WP Get body
WP Get header
WP Paragraph range
WP Picture range
WP SELECT
WP Selection range
WP Table range
Produit : 4D
Thème : 4D Write Pro - Langage
Numéro :
1341
Créé : 4D v15 R4
Modifié : 4D v16 R5
Renommé : 4D v16 R5
Modifié : 4D v17 R3
Renommé : 4D v17 R5
4D Write Pro ( 4D v18)
