PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Présentation du champ de saisie
  • Créer un champ de type "Champ de saisie"
  • Principales caractéristiques d'un champ de saisie
  • Type d'un champ de saisie
  • Type et masques
  • Afficher un texte d'indication dans un champ de saisie
  • Autres caractéristiques importantes
  • Personnalisation du clavier alphabétique
  • Permuter
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation du champ de saisie
Le Champ de saisie permet à l'utilisateur de saisir directement une information. Le champ de saisie peut être aussi utilisé pour visualiser une information.
Versions 15 et supérieures
Android Les champs de saisie sont désormais disponibles pour les applications Android.
Nouveauté 15
Android Les champs de saisie sont désormais disponibles pour les applications Android.
Android Les champs de saisie sont désormais disponibles pour les applications Android.
Versions 16 et supérieures
iPhone/iPad Les champs de saisie sont désormais disponibles pour les applications iPhone/iPad.
Nouveauté 16
iPhone/iPad Les champs de saisie sont désormais disponibles pour les applications iPhone/iPad.
iPhone/iPad Les champs de saisie sont désormais disponibles pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Les champs de saisie sont désormais disponibles pour les applications en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Les champs de saisie sont désormais disponibles pour les applications en mode Windows Store apps.
Universal Windows 10 App Les champs de saisie sont désormais disponibles pour les applications en mode Windows Store apps.

Créer un champ de type "Champ de saisie"

Pour créer un champ de type "Champ de saisie" :
  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.
Remarque : Il est également possible de créer un champ de saisie à partir d'une liste de champs prédéfinis livrés en standard en déroulant "Saisie". La liste des champs disponibles avec leur aperçu au gabarit du projet apparaît. Il suffit de cliquer sur le champ voulu pour le créer dans l'éditeur.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Éditeur d'états : Il est également possible de créer un champ de saisie dans un état. Pour plus de détails, consultez Saisie dans les états.
Principales caractéristiques d'un champ de saisie

Type d'un champ de saisie

Selon le type d'information affichée ou saisie, le format d'un champ de saisie peut varier. Il est ainsi possible de créer un champ de saisie de type :
  • Texte pour afficher ou saisir une chaîne de caractères (nom, adresse, ...).
  • Texte multiligne pour afficher ou saisir plusieurs lignes séparées par un "Retour Chariot".
  • Windows Mobile Texte RTF pour saisir et afficher des informations au format RTF.
  • Mot de passe : lors de la saisie d'informations, tous les caractères seront remplacés par des étoiles à l'écran.
  • Numérique pour afficher ou saisir une valeur numérique (poids, ...). Si le champ n'est pas assez grand pour afficher le chiffre en entier, les caractères "+++" sont affichés.
  • Monétaire pour afficher ou saisir des valeurs monétaires.
  • Monétaire + Euro pour gérer des prix par exemple
  • Date pour afficher ou saisir des dates.
  • Heure pour saisir ou afficher des heures.
  • Durée pour saisir ou afficher des durées.
  • Versions 24 et supérieures
    Jetons de texte pour gérer une saisie avec jetons.
    Nouveauté 24
    Jetons de texte pour gérer une saisie avec jetons.
    Jetons de texte pour gérer une saisie avec jetons.

Type et masques

Masque de saisie : Pour chaque type de champ de saisie, un grand nombre de masques de saisie est utilisable.
Ces masques de saisie sont multilingues : il est possible de sélectionner des masques de saisies différents selon la langue d'exécution du projet. Pour plus de détails, consultez Multilangue dans les champs.
Ces masques de saisie peuvent être modifiés en programmation grâce à la propriété MasqueSaisie.
Versions 17 et supérieures
iPhone/iPad Le clavier affiché lors de l'entrée dans le champ s'adapte automatiquement au masque de saisie sélectionné. Ainsi, le clavier numérique sera automatiquement affiché pour saisir dans un champ de saisie utilisant un masque de saisie numérique.
Nouveauté 17
iPhone/iPad Le clavier affiché lors de l'entrée dans le champ s'adapte automatiquement au masque de saisie sélectionné. Ainsi, le clavier numérique sera automatiquement affiché pour saisir dans un champ de saisie utilisant un masque de saisie numérique.
iPhone/iPad Le clavier affiché lors de l'entrée dans le champ s'adapte automatiquement au masque de saisie sélectionné. Ainsi, le clavier numérique sera automatiquement affiché pour saisir dans un champ de saisie utilisant un masque de saisie numérique.
Versions 17 et supérieures
AndroidJava Masque d'affichage : Il est également possible de définir des masques d'affichage pour certains types de champs (Monétaire, Monétaire + Euro, Date, Heure et durée). Ces masques d'affichage permettent de définir les caractéristiques du champ lorsqu'il n'est pas en saisie.
Par exemple, un champ de type Date peut avoir :
  • le masque de saisie : "JJ/MM/AAAA".
  • le masque d'affichage : "JJJJ JJ MMMM AAAA" (correspondant à la date en toutes lettres).
Les masques d'affichage peuvent être multilangues et peuvent être modifiés par programmation grâce à la propriété MasqueAffichage.
Nouveauté 17
AndroidJava Masque d'affichage : Il est également possible de définir des masques d'affichage pour certains types de champs (Monétaire, Monétaire + Euro, Date, Heure et durée). Ces masques d'affichage permettent de définir les caractéristiques du champ lorsqu'il n'est pas en saisie.
Par exemple, un champ de type Date peut avoir :
  • le masque de saisie : "JJ/MM/AAAA".
  • le masque d'affichage : "JJJJ JJ MMMM AAAA" (correspondant à la date en toutes lettres).
Les masques d'affichage peuvent être multilangues et peuvent être modifiés par programmation grâce à la propriété MasqueAffichage.
AndroidJava Masque d'affichage : Il est également possible de définir des masques d'affichage pour certains types de champs (Monétaire, Monétaire + Euro, Date, Heure et durée). Ces masques d'affichage permettent de définir les caractéristiques du champ lorsqu'il n'est pas en saisie.
Par exemple, un champ de type Date peut avoir :
  • le masque de saisie : "JJ/MM/AAAA".
  • le masque d'affichage : "JJJJ JJ MMMM AAAA" (correspondant à la date en toutes lettres).
Les masques d'affichage peuvent être multilangues et peuvent être modifiés par programmation grâce à la propriété MasqueAffichage.
Windows MobileiPhone/iPad

Afficher un texte d'indication dans un champ de saisie

Le texte d'indication permet d'afficher un texte d'aide directement dans le champ de saisie vide. Ce texte d'aide s'efface automatiquement dès que l'utilisateur tape le premier caractère dans le champ.
Exemple de bulle d'aide
Ce texte d'indication est disponible pour :
  • les champs de saisie de type texte.
  • Windows MobileiPhone/iPad les champs de saisie de type Numérique, Monétaire, Monétaire + Euro.
    Pour que le texte d'indication apparaisse dans les champs de type Numérique, Monétaire, Monétaire + Euro, il faut cocher l'option "Mise à blanc si zéro" (onglet "Détail" de la description du champ).
    Il est également possible d'afficher les bornes minimales et maximales du champ de saisie numérique :
    • dans le texte d'indication (option "Afficher les bornes dans le texte d'indication" de l'onglet "Détail" de la description du champ).
    • dans la bulle d'aide du champ (option "Afficher les bornes dans la bulle" de l'onglet "Détail" de la description du champ).
La saisie du texte d'aide peut être réalisée :
  • dans la fenêtre de description du champ de saisie (onglet "Aide" en WINDEV / WINDEV Mobile et onglet "Contenu" en WEBDEV).
  • par programmation grâce à la propriété Indication.
Windows MobileiPhone/iPad Le style de l'indication affichée dans le champ est paramétrable dans l'onglet "Style". Par défaut, il correspond au style de la zone de saisie, en gris et italique. Pour le modifier, il suffit de sélectionner l'élément "Texte d'indication" et de cocher l'option "Personnaliser le style du texte d'indication".
Versions 22 et supérieures
La propriété CouleurTexteIndication permet de connaître et de modifier par programmation la couleur du texte d'indication.
Nouveauté 22
La propriété CouleurTexteIndication permet de connaître et de modifier par programmation la couleur du texte d'indication.
La propriété CouleurTexteIndication permet de connaître et de modifier par programmation la couleur du texte d'indication.
Windows MobileJava

Autres caractéristiques importantes

Un champ de saisie peut être :
  • Windows Mobile en saisie assistée : Lors de la saisie dans le champ, l'application propose automatiquement la valeur correspondante présente dans la rubrique clé HFSQL liée au champ.
    Par exemple, dans le champ "Ville", après avoir saisi "Ly", la valeur "Lyon" est automatiquement proposée.
    La saisie assistée fonctionne uniquement sur les rubriques clé et sur les rubriques de type Texte.
    La saisie assistée ne fonctionne pas sur les rubriques non clé, sur les rubriques numérique, et si un masque de saisie est utilisé pour les dates. Pour plus de détails, consultez Saisie assistée dans un champ de saisie
Un champ de saisie peut également proposer :
    • Windows Mobile un historique des saisies : Lors de la saisie dans le champ, la liste des précédentes valeurs saisies effectuées dans ce champ sera automatiquement proposée. Cet historique des saisies n'est pas proposé pour les champs multilignes. Pour plus de détails, consultez Mémoriser la saisie effectuée (FAA).
    Windows Mobile Un champ de saisie peut également :
    • activer le clavier en saisie : lors de la saisie dans le champ, le clavier sera automatiquement affiché sur le Pocket PC. Cette option est présente dans l'onglet "Détail" de la fenêtre de description du champ.
    • être en mode Smartphone : la taille du champ est automatiquement optimisé lorsqu'il s'affiche dans un Smartphone. Pour plus de détails, consultez Mode Smartphone.
    Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
    Versions 17 et supérieures
    Android

    Personnalisation du clavier alphabétique

    Dans les applications Android, lors de la saisie dans un champ texte, un clavier alphabétique apparaît automatiquement. Ce clavier permet à l'utilisateur de saisir le texte voulu.
    Ce clavier comporte un bouton en bas à droite qui peut être personnalisé :
    Pour paramétrer ce bouton :
    1. Affichez l'onglet "Détail" de la fenêtre de description du champ de saisie.
    2. Dans l'option "Bouton clavier", sélectionnez le type de bouton voulu. Selon le type sélectionné, le système affichera le bouton correspondant dans la langue en cours sur l'appareil.
    3. Validez.
    L'événement associé à ce bouton peut être saisi dans l'éditeur de code. Il correspond à l'événement optionnel "Validation par le clavier". Pour plus de détails, consultez Evénements associés au champ de saisie.
    Nouveauté 17
    Android

    Personnalisation du clavier alphabétique

    Dans les applications Android, lors de la saisie dans un champ texte, un clavier alphabétique apparaît automatiquement. Ce clavier permet à l'utilisateur de saisir le texte voulu.
    Ce clavier comporte un bouton en bas à droite qui peut être personnalisé :
    Pour paramétrer ce bouton :
    1. Affichez l'onglet "Détail" de la fenêtre de description du champ de saisie.
    2. Dans l'option "Bouton clavier", sélectionnez le type de bouton voulu. Selon le type sélectionné, le système affichera le bouton correspondant dans la langue en cours sur l'appareil.
    3. Validez.
    L'événement associé à ce bouton peut être saisi dans l'éditeur de code. Il correspond à l'événement optionnel "Validation par le clavier". Pour plus de détails, consultez Evénements associés au champ de saisie.
    Android

    Personnalisation du clavier alphabétique

    Dans les applications Android, lors de la saisie dans un champ texte, un clavier alphabétique apparaît automatiquement. Ce clavier permet à l'utilisateur de saisir le texte voulu.
    Ce clavier comporte un bouton en bas à droite qui peut être personnalisé :
    Pour paramétrer ce bouton :
    1. Affichez l'onglet "Détail" de la fenêtre de description du champ de saisie.
    2. Dans l'option "Bouton clavier", sélectionnez le type de bouton voulu. Selon le type sélectionné, le système affichera le bouton correspondant dans la langue en cours sur l'appareil.
    3. Validez.
    L'événement associé à ce bouton peut être saisi dans l'éditeur de code. Il correspond à l'événement optionnel "Validation par le clavier". Pour plus de détails, consultez Evénements associés au champ de saisie.
    Permuter
    Versions 20 et supérieures
    Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJava WINDEV et WINDEV Mobile permettent de transformer automatiquement un champ de saisie en plusieurs libellés :
    1. Sélectionnez le champ de saisie à transformer.
    2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Champ de saisie vers Libellés".
    Un libellé est automatiquement créé pour le libellé du champ de saisie et un libellé est également créé pour la zone de saisie.
    Nouveauté 20
    Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJava WINDEV et WINDEV Mobile permettent de transformer automatiquement un champ de saisie en plusieurs libellés :
    1. Sélectionnez le champ de saisie à transformer.
    2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Champ de saisie vers Libellés".
    Un libellé est automatiquement créé pour le libellé du champ de saisie et un libellé est également créé pour la zone de saisie.
    Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJava WINDEV et WINDEV Mobile permettent de transformer automatiquement un champ de saisie en plusieurs libellés :
    1. Sélectionnez le champ de saisie à transformer.
    2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Champ de saisie vers Libellés".
    Un libellé est automatiquement créé pour le libellé du champ de saisie et un libellé est également créé pour la zone de saisie.
    Liste des exemples associés :
    Le champ de saisie Exemples unitaires (WINDEV) : Le champ de saisie
    [ + ] Utilisation d'un champ de saisie
    Le champ de saisie RTF Exemples unitaires (WINDEV Mobile) : Le champ de saisie RTF
    [ + ] Utilisation de texte au format RTF dans les champs de saisie.
    Ce format est très pratique pour la mise en forme et la visualisation des données.
    Les caractères spéciaux Exemples unitaires (WINDEV) : Les caractères spéciaux
    [ + ] Manipulation de caractères spéciaux dans un champ RTF et visualisation des codes ASCII et ANSI.
    Les fonctions de reconnaissance vocale Exemples unitaires (WINDEV) : Les fonctions de reconnaissance vocale
    [ + ] Utilisation des fonctions de reconnaissance vocale.
    Les commandes vocales de Windows Vista (ou de Windows XP, avec un logiciel tiers) permettent de piloter des applications WINDEV à la voix.
    Par défaut, une application WINDEV répond déjà à la voix, lorsque l'on dicte dans un champ de saisie, ou lorsque l'on énonce le libellé d'un bouton.
    Il est également possible de programmer une commande vocale spécifique pour effectuer une action particulière.
    Masque de saisie avancé Exemples unitaires (WINDEV) : Masque de saisie avancé
    [ + ] Manipulation des masques de saisie dans WINDEV :
    - Définition du format des positifs/négatifs dans un champ de saisie numérique
    - Définition de l'apparence des négatifs dans un champ de saisie numérique
    - Définition de l'apparence de la valeur 0 dans un champ de saisie numérique
    - Utilisation d'une expression régulière pour empêcher la saisie d'autres caractères que les chiffres 1, 2, 3, 4, 5 et 6.
    - Utilisation d'une expression régulière pour "réguler" la saisie d'un numéro de plaque d'immatriculation français
    WD Champ Recherche Exemples didactiques (WINDEV) : WD Champ Recherche
    [ + ] Cet exemple montre comment gérer un champ de saisie permettant de réaliser des recherches FullText de type "google" dans votre base de données.
    WW_Rewali Exemples complets (WEBDEV) : WW_Rewali
    [ + ] Cet exemple est un site de réservation de voyages.

    Il propose des offres de voyages à des prix très attractifs.
    Il est ensuite possible de choisir la durée du voyage, les dates de départ .. puis de valider l'achat jusqu'au paiment via Paypal.

    Il utilise notamment le champ "bandeau défilant" et les plans.
    Version minimum requise
    • Version 9
    Documentation également disponible pour…
    Commentaires
    Cliquez sur [Ajouter] pour publier un commentaire