WP Selection range
WP Selection range ( {* ;} zoneWP ) -> Résultat
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, zoneWP est un nom d'objet de formulaire (chaîne). Si omis, zoneWP est un champ ou une variable objet. |
| zoneWP | Text | → | Nom d'objet de formulaire (si * spécifié) ou champ ou variable objet 4D Write Pro (si * omis) |
| Résultat | Object | ← | Nouvel objet plage ou image |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Compatibilité
La commande WP Selection range était nommée WP Get selection dans les versions précédentes de 4D Write Pro. Elle a été renommée pour plus de clarté.
Description
La commande WP Selection range retourne une nouvelle plage de sélection ou une nouvelle image basée sur la sélection courante dans la zone 4D Write Pro zoneWP.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre zoneWP est un nom d’objet (une chaîne). Si vous ne passez pas le paramètre, vous indiquez que le paramètre zoneWP est un champ ou une variable objet. Si le paramètre zoneWP ne désigne pas une zone 4D Write Pro, un objet vide est retourné.
Note : Cette commande ne peut être utilisée que si zoneWP est associée à un objet de formulaire (i.e. elle est affichée dans le formulaire/la page courant(e)).
Si une image ancrée (image à emplacement fixe) est sélectionnée dans wpArea, WP Selection range retourne un objet contenant une référence d'image et non un objet plage (pour plus d'informations, reportez-vous à la description de la commande WP Add picture). Sinon, WP Selection range retourne un nouvel objet de type objPlage (pour plus d'informations, reportez-vous au paragraphe Gestion des plages).
Exemple
Vous souhaitez récupérer le texte sélectionné dans une zone 4D Write Pro :
$range:=WP Selection range(*;"WParea")