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

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([Products]Comments;vFirst;vLast)
If(vFirst < vlast)
    ALERT("The selected text is:"+Substring([Products]Comments;vFirst;vLast-vFirst))
End if

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)

Voir aussi

FILTER KEYSTROKE
HIGHLIGHT TEXT
Keystroke

Propriétés

Numéro de commande	209
Thread safe	✗