Présentation

• directement par l'utilisateur final,
• par programmation.

Fonctionnement du champ de saisie à jetons (en exécution)

• Un jeton est automatiquement ajouté dans le champ lorsque l'utilisateur utilise la touche Entrée ou un des caractères séparateur spécifié.
• Si la zone de saisie a le focus :
  • Le clic sur un jeton supprime le curseur de saisie.
  • L'utilisation des flèches permet de sélectionner un jeton et supprime le curseur de saisie.
• Si un jeton est sélectionné :
  • l'utilisation des flèches du clavier et des touches Origine et Fin permet de sélectionner et de se déplacer parmi les jetons.
  • l'utilisation de la touche Suppr permet de supprimer le jeton sélectionné.
  • la touche Retour Arr permet de supprimer le jeton précédent.
• L'utilisation de la croix permet de supprimer le jeton voulu.
• Si l'utilisateur n'a pas encore le focus dans la zone de saisie :
  • La touche Tabulation donne le focus à la zone de saisie si le champ de saisie est actif.
  • La touche Tabulation donne le focus au premier jeton si le champ de saisie est en affichage.
• La prise de focus par un autre champ fait perdre le focus à la zone de saisie et/ou au jeton sélectionné.

Créer un champ de saisie de type Jetons de texte

1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur .
2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé. Le champ apparaît en création.
3. Dans la fenêtre de description du champ de saisie, sélectionnez le type "Jetons de texte" et validez.

Remarque : Il est également possible de créer un champ de saisie de type Jetons de texte à partir d'une liste de champs prédéfinis livrés en standard en déroulant "Saisie" (sous l'icône ). La liste des champs disponibles avec leur aperçu au gabarit du projet apparaît. Il suffit de cliquer sur le champ Jeton ou Email (dans la catégorie "Autres types") pour créer un champ de saisie de type Jetons de texte dans l'éditeur.

Options spécifiques au champ de saisie de type Jetons de texte

• les options de gestion du champ et des jetons (onglet "Général").
• le style des jetons (Onglet "Style").

• Masque de saisie : Lorsque la saisie directe des jetons est autorisée, il est possible de choisir un masque de saisie, comme pour tout champ de saisie. L'utilisateur final est ainsi guidé : email, majuscules, valeurs numériques, code postal, ...
• Séparateurs de saisie (en plus de <RC>) : Liste des caractères considérés comme un séparateur de jetons. Lorsque l'utilisateur saisira un de ces caractères, un jeton sera créé avec le contenu de la zone de saisie et l'utilisateur passera à la saisie du jeton suivant. Cette liste est manipulable par programmation grâce à la propriété JetonListeSéparateur.
• Unicode : Autorise la saisie de caractères unicode.
• Autoriser les doublons : Autorise la saisie de doublons dans les jetons. Si cette option est sélectionnée, l'utilisateur pourra saisir plusieurs fois le même texte pour le jeton. Cette option est manipulable par programmation grâce à la propriété JetonAutoriseDoublon.
• Retour à la ligne automatique : Permet de gérer le fonctionnement en cas de saisie de nombreux jetons : il est possible d'afficher les jetons sur plusieurs lignes (option cochée) ou bien d'afficher un ascenseur horizontal pour visualiser tous les jetons.
• Jetons supprimables : Permet d'autoriser l'utilisateur à supprimer les jetons du champ de saisie. Dans ce cas, une croix sera affichée dans le jeton. Cette option est manipulable par programmation grâce à la propriété JetonSupprimable.

• le style du libellé du jeton (élément "Jetons : Libellé").
• le style du jeton (élément "Jetons : Cadre"). Dans ce cas, il est possible de sélectionner :
  • le picto utilisé pour la croix du jeton,
  • la couleur de fond et de cadre du jeton.
  • le type de cadre du jeton.
• Versions 26 et supérieures
  le style du jeton sélectionné (élément "Jetons : Sélection"). Il est alors possible de sélectionner la couleur du jeton sélectionné. La couleur "Automatique" permet d'adapter automatiquement la couleur du jeton sélectionné en fonction de la couleur du texte. Le texte du jeton est ainsi toujours lisible.
  Nouveauté 26
  le style du jeton sélectionné (élément "Jetons : Sélection"). Il est alors possible de sélectionner la couleur du jeton sélectionné. La couleur "Automatique" permet d'adapter automatiquement la couleur du jeton sélectionné en fonction de la couleur du texte. Le texte du jeton est ainsi toujours lisible.
  le style du jeton sélectionné (élément "Jetons : Sélection"). Il est alors possible de sélectionner la couleur du jeton sélectionné. La couleur "Automatique" permet d'adapter automatiquement la couleur du jeton sélectionné en fonction de la couleur du texte. Le texte du jeton est ainsi toujours lisible.

Evénements associés

• Ajout d'un jeton.
• Suppression d'un jeton.
• Clic sur un jeton.

Fonctions et propriétés WLangage associés

• le type de variable Jeton, permettant de connaître et de définir toutes les caractéristiques du jeton.
• les fonctions de gestion des jetons :
  • syntaxe classique :
    

    Versions 24 et supérieures SaisieAjouteJeton Nouveauté 24 SaisieAjouteJeton SaisieAjouteJeton	Ajoute un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures SaisieInsèreJeton Nouveauté 24 SaisieInsèreJeton SaisieInsèreJeton	Insère un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures SaisieOccurrenceJeton Nouveauté 24 SaisieOccurrenceJeton SaisieOccurrenceJeton	Renvoie le nombre de jetons présent un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures SaisieSupprimeJeton Nouveauté 24 SaisieSupprimeJeton SaisieSupprimeJeton	Supprime un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures SaisieSupprimeToutJeton Nouveauté 24 SaisieSupprimeToutJeton SaisieSupprimeToutJeton	Supprime tous les jetons d'un champ de saisie de type "Jetons de texte".
  • syntaxe préfixée :
    

    Versions 24 et supérieures <Saisie>.AjouteJeton Nouveauté 24 <Saisie>.AjouteJeton <Saisie>.AjouteJeton	Ajoute un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures <Saisie>.InsèreJeton Nouveauté 24 <Saisie>.InsèreJeton <Saisie>.InsèreJeton	Insère un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures <Saisie>.OccurrenceJeton Nouveauté 24 <Saisie>.OccurrenceJeton <Saisie>.OccurrenceJeton	Renvoie le nombre de jetons présent un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures <Saisie>.SupprimeJeton Nouveauté 24 <Saisie>.SupprimeJeton <Saisie>.SupprimeJeton	Supprime un jeton dans un champ de saisie de type "Jetons de texte".
    Versions 24 et supérieures <Saisie>.SupprimeToutJeton Nouveauté 24 <Saisie>.SupprimeToutJeton <Saisie>.SupprimeToutJeton	Supprime tous les jetons d'un champ de saisie de type "Jetons de texte".
• les propriétés permettant de manipuler les jetons et leurs caractéristiques :
  

  Versions 24 et supérieures Jeton Nouveauté 24 Jeton Jeton	La propriété Jeton permet de manipuler les différents jetons associés à un champ de saisie de type "Texte avec jetons".
  Versions 24 et supérieures JetonActif Nouveauté 24 JetonActif JetonActif	La propriété JetonActif permet de savoir si un champ de saisie est un champ de saisie de type "Jetons de texte".
  Versions 24 et supérieures JetonAutoriseDoublon Nouveauté 24 JetonAutoriseDoublon JetonAutoriseDoublon	La propriété JetonAutoriseDoublon permet de : Autoriser ou non la saisie de doublons dans un champ de saisie de type "Jetons de texte". Savoir si les doublons sont autorisés dans un champ de saisie de type "Jetons de texte".
  Versions 24 et supérieures JetonListeSéparateur Nouveauté 24 JetonListeSéparateur JetonListeSéparateur	La propriété JetonListeSéparateur récupère ou modifie les séparateurs qui déclenchent la création de nouveaux jetons durant la saisie dans un champ de saisie de type "Jetons de texte".
  Versions 24 et supérieures JetonSaisieEnCours Nouveauté 24 JetonSaisieEnCours JetonSaisieEnCours	La propriété JetonSaisieEnCours permet de lire ou modifier la valeur en cours de saisie dans un champ de saisie de type "Jetons de texte".
  Versions 24 et supérieures JetonSupprimable Nouveauté 24 JetonSupprimable JetonSupprimable	La propriété JetonSupprimable permet de : Savoir si la suppression des jetons par l'utilisateur final est autorisée ou non dans un champ de saisie de type "Jetons de texte". Autoriser ou non la suppression des jetons par l'utilisateur final dans un champ de saisie de type "Jetons de texte".
  Versions 09 et supérieures ValeurMémorisée Nouveauté 09 ValeurMémorisée ValeurMémorisée	La propriété ValeurMémorisée permet de connaître la valeur actuellement mémorisée par : une ligne d'un champ Liste (y compris Liste image) ou d'un champ Combo. un champ de saisie de type "Jetons de texte".