PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Nouveauté WINDEV, WEBDEV, WINDEV Mobile 24 !
  • Champ de saisie de type Jetons de texte
  • Présentation
  • Fonctionnement du champ de saisie à jeton (en exécution)
  • Caractéristiques du champ de saisie de type Jetons de texte
  • Créer un champ de saisie de type Jetons de texte
  • Options spécifiques au champ de saisie de type Jetons de texte
  • Manipuler un champ de saisie de type Jetons de texte par programmation
  • Traitements associés
  • Fonctions et propriétés WLangage associés
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Champ de saisie de type Jetons de texte

Présentation

Les interfaces utilisant des champs à jetons sont courantes. Un champ à jetons contient des informations en nombre variable dans une zone limitée.
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.
Quand l’utilisateur choisit un nouveau critère, ce critère s’ajoute dans le champ.
Si l’utilisateur décide de supprimer un critère de choix, il lui suffit de cliquer sur la croix à côté du critère.
Dans WINDEV, WEBDEV, WINDEV Mobile, pour gérer un champ à jetons, il suffit de créer un champ de saisie de type "Jetons de texte". Les différents jetons peuvent être saisis :
  • directement par l'utilisateur final,
  • par programmation.

Fonctionnement du champ de saisie à jeton (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é.
Caractéristiques du champ de saisie de type Jetons de texte

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

Pour 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

La fenêtre de description du champ de saisie de type Jetons de texte permet de définir :
  • les options de gestion du champ et des jetons (onglet "Général").
  • 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 jeton. 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.
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,
    • la couleur de fond et de cadre du jeton.
    • le type de cadre du jeton.
Manipuler un champ de saisie de type Jetons de texte par programmation

Traitements associés

En exécution, l'utilisateur peut ajouter, supprimer ou sélectionner des jetons dans un champ de saisie.
Plusieurs traitements permettent de gérer ces actions :
  • Ajout d'un jeton.
  • Suppression d'un jeton.
  • Clic sur un jeton.
Ces traitements sont des traitements avec procédure, permettant de récupérer le jeton en cours dans une variable de type Jeton.
Pour plus de détails sur ces traitements, consultez Traitements associés aux champs de saisie.

Fonctions et propriétés WLangage associés

Pour manipuler un champ de saisie de type Jetons de texte par programmation, le WLangage met à votre disposition :
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire