|
|
|
|
|
- Présentation
- Principe
- Saisie assistée "en mémoire"
- Comment le faire ?
- Exemples
- Remarques
- Saisie assistée "Fichier"
- Comment le faire ?
- Saisie assistée "programmée"
- Comment le faire ?
- Exemple
Saisie assistée dans un champ de saisie
Le principe de la saisie assistée dans un champ de saisie est très simple : quand l'utilisateur commence à saisir dans un champ de saisie, une liste se déroule automatiquement sous le champ pour proposer les valeurs commençant par le texte de la saisie en cours. La saisie assistée peut être mise en place automatiquement depuis l'éditeur ou personnalisée par programmation. WINDEV, WINDEV Mobile et WEBDEV proposent plusieurs types de saisie assistée : - Saisie assistée "en mémoire" : Le champ de saisie n'est pas lié à une rubrique d'un fichier de données. La saisie automatique se fait à partir d'une liste de données fournie par programmation (fonction SaisieAssistéeAjoute). L'affichage des données dans la liste est effectué selon la saisie.
- Saisie assistée "fichier" : Le champ de saisie est lié à une rubrique d'un fichier de données ou d'une requête. L'affichage des données dans la liste est effectué selon la saisie.
- Saisie assistée programmée : La saisie assistée est effectuée à partir d'une liste de données personnalisée. L'affichage des données dans la liste selon la saisie est personnalisée.
Saisie assistée "en mémoire" Comment le faire ? Pour mettre en place la saisie assistée "en mémoire" : - Utilisez la fonction SaisieAssistéeAjoute pour ajouter les éléments pris en compte par la saisie assistée.
Il est possible d'ajouter : - une valeur simple, affichée dans la liste des propositions de la saisie assistée,
- une valeur affichée et une valeur mémorisée.
- une variable de type SaisieAssistée.
- Si nécessaire, utilisez la fonction SaisieAssistéeParamètre pour paramétrer les caractéristiques de la saisie assistée : filtre, ouverture de la liste des propositions, nombre de caractères à saisir avant d'ouvrir la liste des propositions, etc.
Remarque : La valeur mémorisée permet d'associer une valeur spécifique à une ligne de la saisie assistée. Cette valeur peut être utilisée par exemple pour réaliser un traitement spécifique selon le type de valeur sélectionnée. Exemples Exemple pour une fenêtre :
SaisieAssistéeParamètre(SAI_Rechercher, saTailleMin, 3)
SaisieAssistéeParamètre(SAI_Rechercher, saFiltre, filtreContient)
POUR TOUTE CHAÎNE sTitre DE gsTitresPhotos SÉPARÉE PAR RC
SaisieAssistéeAjoute(SAI_Rechercher, sTitre)
FIN
Remarques - L'événement optionnel "Sélection d'une valeur dans la liste de saisie assistée" est exécuté lors de la sélection d'un élément. Cet événement prend en paramètre une variable de type SaisieAssistée. Cette variable permet de connaître la valeur sélectionnée et la valeur mémorisée associée si elle existe.
- Par défaut, la valeur affichée dans le champ de saisie lors de la sélection dans la saisie assistée, correspond à la valeur sélectionnée. Pour modifier la valeur du champ de saisie, utilisez l'événement "Sélection d'une valeur dans la liste de saisie assistée". Il est par exemple possible d'afficher la valeur mémorisée dans le champ de saisie.
Pour plus de détails, consultez Evénements associés aux champs de saisie.Saisie assistée "Fichier" Comment le faire ? Pour mettre en place la saisie assistée "Fichier" : - Dans la fenêtre de description du champ de saisie :
- Vérifiez que le champ de saisie est lié à une rubrique d'un fichier de données ou d'une requête (onglet "Liaison").
Attention : La rubrique doit être une clé. - Dans l'onglet "Détail", cochez l'option "Saisie assistée sur liaison fichier".
- Validez la fenêtre de description du champ de saisie.
En exécution, dès la première lettre saisie dans le champ : la première donnée correspondant à la lettre saisie s'affiche. Au fur et à mesure de la saisie, la donnée correspondant aux lettres saisies s'affiche.
Remarques : - Si le champ de saisie est lié à une rubrique d'une requête, la requête est automatiquement exécutée. Cependant, si cette requête attend des paramètres, il est nécessaire de les renseigner puis d'exécuter la requête avec la fonction HExécuteRequête (par exemple dans l'événement "Déclarations globales" ou l'événement "Fin d'initialisation" de la fenêtre).
- Le filtre d'affichage de la saisie assistée est de type "Commence par". Pour utiliser un autre filtre, il est nécessaire d'utiliser la saisie assistée programmée.
Saisie assistée "programmée" Comment le faire ? La saisie assistée programmée permet de manipuler une source de données personnalisée. Pour utiliser la saisie assistée programmée : - Désactivez le filtre par défaut grâce à la fonction SaisieAssistéeParamètre (en utilisant la constante filtreAucun). La liste de la saisie assistée pourra ainsi s'ouvrir et afficher tous les éléments spécifiés.
- Dans l'événement "A chaque modification" du champ de saisie :
Exemple
POUR TOUT sNom, sCode de gTabAction
SI Contient(sCode, SAI_Mode_programmé) _OU_ ...
Contient(sNom, SAI_Mode_programmé) ALORS
SaisieAssistéeAjoute(FEN_EnMémoire.SAI_Mode_programmé, sNom)
FIN
FIN
Liste des exemples associés :
|
Exemples complets (WEBDEV) : Galerie_Photos
[ + ] Cet exemple est un site de galerie photos et se compose de 2 parties principales : - la partie "visiteur", réalisée en mode AWP et référençable. - la partie administration réalisée en mode WEBDEV classique et sécurisée. Parmi les fonctionnalités proposées, vous y trouverez : - une organisation par albums de vos photos - un lien vers les réseaux sociaux - la possibilité pour les visiteurs de commenter vos publications - la connexion des utilisateurs est gérée via le GPU de WEBDEV - un formulaire de contact - au niveau de l’administration du site, vous pourrez bien évidemment uploader vos photos, les classer par album et aussi les décrire
|
|
Exemples unitaires (WINDEV) : Les fonctions SaisieAssistée
[ + ] Utilisation des fonctions WLangage SaisieAssistée. Ces fonctions permettent de mettre en place facilement une saisie assistée sur les champs.
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|