DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Masques de saisie et d'affichage
  • Présentation
  • Rappel
  • Masque par défaut
  • Les masques prédéfinis
  • Masque supplémentaire
  • Les masques personnalisés
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation

Rappel

WINDEV, WINDEV Mobile et WEBDEV proposent deux types de masques :
  • les masques de saisie qui définissent les caractères pouvant être saisis dans les champs d'une fenêtre ou d'une page. Parfois, ces masques permettent également de modifier la casse (majuscule / minuscule) des valeurs affectées aux champs d'une fenêtre ou d'une page par programmation.
  • les masques d'affichage qui définissent les caractères pouvant être :
    • WINDEVWINDEV Mobile affichés dans les champs d'une fenêtre.
    • imprimés dans les champs d'un état.
Masque par défaut
Par défaut, lors de la création d'un champ de type Date :
  • le masque de saisie "Date définie par le projet" est sélectionné : les informations définies dans les paramètres de gestion des dates pour le projet sont automatiquement pris en compte. Rappel : Ces paramètres sont définis pour chaque langue dans l'onglet "Langues" de la description du projet :
    1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    2. Sélectionnez l'onglet "Langues" puis l'onglet "Date".
    3. Le format utilisé correspond :
      • soit aux paramètres du système d'exploitation,
      • soit aux paramètres spécifiés (avec les jours et mois définis).
  • WINDEVWINDEV Mobile le masque d'affichage "Même masque que la saisie" est sélectionné.
Remarques :
  • Dans un état, lors de la création d'un champ prédéfini de type Date, l'assistant permet de sélectionner le format d'affichage du champ.
  • Dans la fenêtre de description du champ, une liste de masques prédéfinis est proposée. Vous pouvez au choix :
    • soit sélectionner un masque prédéfini.
    • soit créer un masque personnalisé.
Les masques prédéfinis
Les masques suivants sont proposés (ordre d'apparition sous l'éditeur de fenêtres, de pages et d'états) :
  • la date définie par le projet. La date définie par le projet dépend du format de date sélectionné dans les paramètres de la langue du projet (option "Projet .. Description du projet", onglet "Langues", options linguistiques concernant la date).
  • 'JJ/MM/AAAA' ("01/02/1979" par exemple)
  • 'JJ/MM/AA' ("01/02/79" par exemple)
  • 'JJJ JJ' ("Mar 15" par exemple)
  • 'MM/JJ/AAAA' ("02/01/1979" par exemple)
  • 'MM/JJ/AA' ("02/01/79" par exemple)
  • 'AAAA/MM/JJ' ("1979/02/01" par exemple)
  • 'AA/MM/JJ' ("79/02/01" par exemple)
  • 'JJ/MM/AAAA HH:mm:SS' ("01/02/1979 21:35:15" par exemple)
  • 'MM/JJ/AAAA HH:mm:SS' ("02/01/1979 21:35:15" par exemple)
  • 'JJ/MM/AAAA HH:mm:SS:CC' ("01/02/1979 21:35:15:10" par exemple)
  • 'MM/JJ/AAAA HH:mm:SS:CC' ("02/01/1979 21:35:15:10" par exemple)
  • 'JJJJ JJ MMMM AAAA' ("Jeudi 01 février 1979" par exemple)
  • 'Jjjj JJ Mmmm AAAA' ("Mardi 13 Juin 2000" par exemple)
  • 'Jjjj JJ Mmm AAAA' ("Samedi 01 Déc 2001" par exemple)
Des masques supplémentaires sont disponibles en WINDEV et WEBDEV :
  • WEBDEV - Code Serveur Date (HTML5)
  • WEBDEV - Code Serveur Date et Heure (HTML5)
  • WINDEVWINDEV Mobile Durée relative (Hier, dans 3 jours, ...).
    Android Ce masque n'est pas disponible.
WEBDEV - Code Serveur Masques supplémentaires En WEBDEV, il est également possible de sélectionner des masques de saisie HTML 5. Ces masques de saisie permettent d'utiliser les contrôles HTML 5 pour valider la saisie.
Attention : Ces masques ne sont pas gérés par tous les navigateurs et leur fonctionnement peut différer selon le navigateur utilisé.
Les masques de saisie HTML 5 disponibles sont les suivants :
Masque sélectionnéButEffets lors de la saisie dans le champ
Date (HTML5)Saisie d'une date au format AAAA-MM-JJ
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, un message demandant de saisir une valeur correcte est affiché.
  • Edge 38 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
Date et Heure (HTML5)Saisie d'une date et heure au format AAAA-MM-JJTHH:MM
  • Internet Explorer 9 : Non géré.
  • Internet Explorer 11 : Non géré.
  • Edge 38 : Non géré.
  • FireFox 5 : Non géré.
  • Chrome 12 : Champ avec spin permettant de modifier la date et l'heure automatiquement.
    Lors de la validation du formulaire, si la valeur saisie est incorrecte, une bulle d'aide demandant de saisir une valeur correcte est affichée. Le focus est mis sur le champ.
  • Opéra 11.11 : Combo avec une flèche permettant de dérouler un calendrier pour la partie date, et spin permettant de modifier la partie heure.
  • Safari 5 : Lors de la validation du formulaire, si la valeur saisie est incorrecte, le focus est mis sur le champ.
WINDEVWINDEV Mobile

Masque supplémentaire

En WINDEV et WINDEV Mobile, il est possible de sélectionner un masque d'affichage supplémentaire : "Durée relative (Hier, dans 3 jours, ...)".
Ce masque permet d'exprimer la durée écoulée (ou à venir) entre la date du jour et la date saisie dans le champ. Ce format est exprimé en langage naturel.
Les différentes formulations utilisées sont configurables dans la description du projet pour la langue en cours :
  1. Sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
  2. Dans l'onglet "Langues" :
    • sélectionnez la langue à configurer.
    • sélectionnez l'onglet "Date".
  3. Cliquez sur le bouton "Dates et Heures en langage naturel".
  4. Définissez les libellés personnalisés à utiliser si nécessaire. Ces libellés seront utilisés :
    • pour le résultat de la fonction DateVersChaîne (utilisée avec la constante maskDateDuréeRelative).
    • pour les champs de saisie de type Date utilisant le masque d'affichage "Durée relative".
Les masques personnalisés
Les éléments suivants peuvent être utilisés pour définir un masque personnalisé (attention, il est nécessaire de respecter la casse) :
  • 'JJJJ' (jour correspondant de la semaine, par exemple "Jeudi". La casse utilisée dépend des options linguistiques du projet.)
  • 'Jjjj' (jour correspondant de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
  • 'jjjj' (jour correspondant de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
  • 'JJJ' (abréviation du jour de la semaine, par exemple "Jeu")
  • 'Jjj' (abréviation du jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lun)
    Java Cette notation n'est pas disponible.
  • 'jjj' (abréviation du jour de la semaine avec la première lettre forcée en minuscule, par exemple : lun)
    Java Cette notation n'est pas disponible.
  • 'JJ' (date en chiffres, par exemple "25")
  • 'MMMM' (mois en toutes lettres, par exemple "Janvier". La casse utilisée dépend des options linguistiques du projet.)
  • 'Mmmm' (mois en toutes lettres avec la première lettre forcée en majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
  • 'mmmm' (mois en toutes lettres avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
  • 'MMM' (abréviation du mois, par exemple "Jan")
  • 'Mmm' (abréviation du mois avec la première lettre forcée en majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
  • 'mmm' (abréviation du mois avec la première lettre forcée en minuscule, par exemple : jan)
    Java Cette notation n'est pas disponible.
  • 'MM' (mois en chiffres, par exemple "06")
  • 'AAAA' (l'année sur quatre chiffres, par exemple "2001")
  • 'AA' (deux derniers chiffres de l'année, par exemple "01")
  • 'HH' (heure en chiffres, par exemple "13")
  • 'mm' (minutes en chiffres, par exemple "32")
  • 'SS' (secondes en chiffres, par exemple "46")
Il est possible de combiner ces masques. Par exemple : 'Le JJJ JJ MMMM AAAA à HH:mm' donnera un résultat de la forme "Le Jeu 01 Février 1979 à 21:35".
WEBDEV - Code Serveur Les masques de saisie personnalisés sont gérés uniquement en affichage : ils ne sont pas disponibles lors de la saisie dans le champ par l'internaute.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale