GET HIGHLIGHT

4D v20 R7

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	Champ, Variable, Objet de formulaire	Nom d’objet (si * est spécifié) ou Champ ou variable (si * est omis)
débutSél	Entier long	Position du début de la sélection de texte
finSél	Entier long	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([Produits]Notes;vPremier;vDernier)

 If(vPremier<vDernier)

    ALERT("Le texte sélectionné est : "+Substring([Produits]Notes;vPremier;vDernier-vPremier))

 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