GET HIGHLIGHT
GET HIGHLIGHT ( {* ;} objet ; débutSél ; finSél )
| Paramètre | Type | Description | |
|---|---|---|---|
| * | Opérateur | → | Si spécifié, objet est un nom d’objet (chaîne) Si omis, objet est un champ ou une variable |
| objet | Field, Variable, any | → | Nom d’objet (si * est spécifié) ou Champ ou variable (si * est omis) |
| débutSél | Integer | ← | Position du début de la sélection de texte |
| finSél | Integer | ← | Position de la fin de la sélection de texte |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande GET HIGHLIGHT vous permet de déterminer précisément le texte actuellement sélectionné dans objet.
Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet désigne le nom d’un objet (une chaîne). Si vous ne passez pas le paramètre *, vous indiquez que le paramètre objet désigne un champ ou une variable. Dans ce cas, vous ne passez pas une chaîne de caractères mais la référence du champ ou de la variable (champs ou variables de formulaire uniquement).
Note : Cette commande ne peut pas être utilisée avec des champs situés dans le formulaire en mode liste d'un sous-formulaire.
Le texte peut être sélectionné par l'utilisateur ou par la commande HIGHLIGHT TEXT.
Le paramètre débutSél retourne la position du premier caractère sélectionné.
Le paramètre finSél retourne la position du dernier caractère sélectionné plus un.
Si les valeurs débutSél et finSél retournées sont identiques, l'utilisateur n'a pas sélectionné de texte et le point d'insertion est placé devant le caractère spécifié par débutSél.
Si l'objet désigné par le paramètre objet n'est pas trouvé dans le formulaire, la commande retourne -1 dans débutSél et -2 dans finSél.
Exemple 1
L'exemple suivant récupère le texte sélectionné dans le champ [Produits]Notes :
GET HIGHLIGHT([Produits]Notes;vPremier;vDernier)
If(vPremier<vdernier) alert("le="" texte="" sélectionné="" est="" :="" "+substring([produits]notes;vpremier;vdernier-vpremier))="" end="" if<="" pre=""></vdernier)>
Exemple 2
Reportez-vous à l'exemple de la commande FILTER KEYSTROKE.
Exemple 3
Modification du style du texte sélectionné :
GET HIGHLIGHT(*;"monTexte";$debutsel,$finsel)
ST SET ATTRIBUTES(*;"monTexte";$debutsel,$finsel;Attribute underline style;1;Attribute bold style;1)