Présentation

Lorsqu'un grand nombre de possibilités de choix multiples (par exemple sélectionner plusieurs couleurs parmi des dizaines) est offert à l'utilisateur final, le champ à jetons est un moyen aisé de présenter ces choix de manière synthétique.

• 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é.
• Si la multisélection est activée, l'utilisateur peut sélectionner plusieurs jetons via la touche Ctrl.

FAA (Fonctionnalités automatiques de vos applications)
Plusieurs FAA sont disponibles via le menu contextuel des jetons :

• Modifier : Permet d'éditer le texte d'un jeton pour le modifier.
• Couper : Permet de copier le texte du jeton et de supprimer le jeton.
  Si la multisélection est possible, cette option coupe tous les jetons sélectionnés.
• Copier : Permet de copier le texte d'un jeton.
  Si la multisélection est possible, cette option copie tous les jetons sélectionnés.
• Tout copier : Permet de copier le texte de tous les jetons.
• Coller : Permet de coller le ou les jetons précédemment copiés ou le texte présent dans le presse-papiers.

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 "Saisie jetons" ou "Saisie eMail à jetons" 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").
• les options de déplacement des jetons par Drag and Drop (onglet "Détail").
• le style des jetons (Onglet "Style").

L'onglet "Général" de la fenêtre de description du champ propose les options suivantes :

• 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.
• Jetons multi-sélectionnables : Permet de réaliser une multi-sélection des jetons (via la touche Ctrl par exemple). Cette option est manipulable par programmation grâce à la propriété Multisélection.

L'onglet "Style" de la fenêtre de description du champ permet de définir :

• 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. L'image utilisée doit avoir les dimensions suivantes : 12 pixels x 12 pixels (dans chaque état).
  • la couleur de fond et de cadre du jeton.
  • le type de cadre du jeton.
• 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ées

• 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 :
    

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

    <Saisie>.AjouteJeton	Ajoute un jeton dans un champ de saisie de type "Jetons de texte".
    <Saisie>.InsèreJeton	Insère un jeton dans un champ de saisie de type "Jetons de texte".
    <Saisie>.OccurrenceJeton	Renvoie le nombre de jetons présents dans un champ de saisie de type "Jetons de texte".
    <Saisie>.SupprimeJeton	Supprime un jeton dans un champ de saisie de type "Jetons de texte".
    <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 :
  

  DndCible	La propriété DndCible permet de connaître et de modifier le comportement d'un champ vis-à-vis du "Drag and Drop".
  DndSource	La propriété DndSource permet de connaître et de modifier le comportement d'un champ vis-à-vis du "Drag and Drop".
  Jeton	La propriété Jeton permet de manipuler les différents jetons associés à un champ de saisie de type "Texte avec jetons".
  JetonActif	La propriété JetonActif permet de savoir si un champ de saisie est un champ de saisie de type "Jetons de texte".
  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".
  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".
  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".
  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".
  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". une ligne d'un champ Table. une ligne de la saisie assistée d'un champ de saisie (si la ligne est sélectionnée).

Ajouter des jetons dans la saisie assistée

MonJeton est un Jeton
MonJeton.Libellé = "abc"
MonJeton.Valeur = "abc"
MonJeton.Bulle = "bulle"
MonJeton.Couleur = RougeFoncé
MonJeton.CouleurFond	= RougePastel
MonJeton2 est un Jeton
MonJeton2.Libellé = "def"
MonJeton2.Valeur = "def"
MonJeton2.Bulle = "bulle"
MonJeton2.Couleur = RougeFoncé
MonJeton2.CouleurFond = RougePastel
SaisieAssistéeAjoute(SAI_ChampAJetons, MonJeton)
SaisieAssistéeAjoute(SAI_ChampAJetons, MonJeton2)