PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Champs de type Numérique (non monétaires)
  • Champs de type Monétaire
  • Champs de type Monétaire + Euro
  • Champs de type Date
  • Champs de type Heure
  • Champs de type DateHeure
  • Champs de type Durée
  • Champs de type Texte sous l'éditeur d'états
  • Champs de type Texte sous l'éditeur de fenêtres
  • Champs de type Jauge
  • Type de masque de saisie
  • Expressions régulières dans les masques de saisie
  • Champ Tableur
  • Limites
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
La propriété ..MasqueSaisie permet de :
  • connaître le masque de saisie.
  • modifier le masque de saisie (parmi les masques disponibles pour le type).
La propriété ..MasqueSaisie s'applique à tous les champs permettant une saisie ou affichant un texte :
  • un champ de saisie.
  • un groupe de champs de saisie.
  • une combo avec saisie.
  • une colonne de table,
  • Versions 17 et supérieures
    WINDEV une colonne de table affichée par une combo.
    Nouveauté 17
    WINDEV une colonne de table affichée par une combo.
    WINDEV une colonne de table affichée par une combo.
  • une cellule de table,
  • une jauge,
  • Versions 15 et supérieures
    un libellé formaté.
    Nouveauté 15
    un libellé formaté.
    un libellé formaté.
La propriété ..MasqueSaisie s'applique également dans les états pour les champs Calculé ou les champs Rubrique.La propriété ..MasqueSaisie s'applique également dans les états pour les champs Calculé ou les champs Libellé.
WEBDEV - Code Serveur Cette propriété est disponible uniquement en Lecture/Ecriture pour les champs d'un état. Pour les champs d'une page, cette propriété n'est pas disponible.
Remarque : Le masque de saisie d'un champ est défini sous l'éditeur de fenêtres ou d'états, dans l'onglet "Général" de la description du champ.
=Masque de saisie
Pour plus de détails sur les différents masques de saisie disponibles et leurs caractéristiques, consultez Masque de saisie.
AndroidJava Les masques de saisie personnalisés ne sont pas supportés.
Versions 16 et supérieures
WINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Nouveauté 16
WINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
WINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Versions 15 et supérieures
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
WINDEV MobileAndroid Cette propriété est désormais disponible pour les applications Android.
Versions 18 et supérieures
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
Nouveauté 18
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.
Versions 20 et supérieures
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
Nouveauté 20
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
WINDEV MobileAndroidiPhone/iPad Cette propriété est désormais disponible pour les colonnes de table dans les applications Android et dans les applications iPhone/iPad.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App pour les états et les champs des états.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App pour les états et les champs des états.
WINDEVWINDEV MobileUniversal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App pour les états et les champs des états.
Exemple
// Modifier le masque du champ "SAI_NomClient"
SAI_NomClient..MasqueSaisie = maskMajus
// Modifier le masque de la 1ère ligne de la table pour la colonne COL_Prix
TABLE_Table1.COL_Prix[1]..MasqueSaisie = "9999,99"
// La valeur affichée tient compte du masque
Info(TABLE_Table1.COL_Prix[1]..ValeurAffichée)
WINDEVWINDEV MobileWindows MobileCode Utilisateur (MCU)
// Accepte le chiffre de 0 à 7 (octal)
MonExpression est une chaîne = "[0-7]"
SAI_Saisie1..MasqueSaisie = "regexp:" + MonExpression
// Masque pour une jauge
JAUGE_Jauge1..MasqueSaisie = "Effectué à 999,99 %"
// Autorise la saisie d'un seul et unique chiffre compris entre 1 et 6
SAI_CHAMP..MasqueSaisie = "regexp:[1-6]{0,1}"

// Autoriser la saisie uniquement de chiffres et du caractère point,
// 10 caractères maximum
SAI_CHAMP..MasqueSaisie = "regexp:[0-9.]{0,10}"

// Masque de saisie d'une plaque d'immatriculation française
SAI_PLAQUEIMM..MasqueSaisie = ...
"regexp:[A-Z]{0,2}[ \-]?[0-9]{0,3}[ \-]?[A-Z]{0,2}"

// Masque de saisie sans limite de taille,
// acceptant les chiffres et des lettres minuscules et majuscules
SAI_CHAMP..MasqueSaisie = "regexp:[0-9a-zA-Z]*"
Syntaxe

Connaître le masque de saisie d'un champ Masquer les détails

<Résultat> = <Nom du champ>..MasqueSaisie
<Résultat> : Constante ou chaîne de caractères
Masque de saisie du champ spécifié. Le masque de saisie dépend du type du champ. Pour plus de détails, consultez les notes.
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler.

Modifier le masque de saisie d'un champ Masquer les détails

<Nom du champ>..MasqueSaisie = <Nouveau masque de saisie>
<Nom du champ> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler.
<Nouveau masque de saisie> : Constante ou chaîne de caractères
Nouveau masque de saisie du champ spécifié. Le masque de saisie dépend du type du champ. Pour plus de détails, consultez les notes.
WINDEVWINDEV Mobile Sous l'éditeur de fenêtres, pour les champs de saisie et les combos, il est possible d'utiliser une expression régulière pour construire le masque de validation : il suffit d'utiliser la chaîne "regexp:" avant l'expression régulière. Pour plus de détails, consultez les notes.
AndroidJava Les masques de saisie personnalisés ne sont pas supportés.
Remarques

Champs de type Numérique (non monétaires)

1. Masques de saisie prédéfinis
maskTailleFichierMasque numérique pour les tailles de fichier et de disque.
Versions 17 et supérieures
maskNombreSystème
Nouveauté 17
maskNombreSystème
maskNombreSystème
Masque numérique utilisé par le système. Correspond au masque sélectionné dans les paramètres régionaux système ("Options régionales" dans le panneau de configuration).
Exemple :
SAI_Saisie1..MasqueSaisie = maskTailleFichier
SAI_Saisie1 = 5681234        // Affiche 5,68 Mo
Le changement d'unité (exemple passage de Ko à Mo) est réalisé à chaque multiple de 1024. Il est donc possible que le masque affiche 1003 Ko.
2. Masques de saisie personnalisés
Les masques de saisie se définissent à l'aide des caractères : "9", ".", ",", "+" et "-", "$" et espaces. Par exemple : "99.999,99".
En affichage, les masques tiennent compte en affichage des séparateurs décimaux, de milliers et du symbole défini par la langue.
En programmation (quelque soit la langue) :
  • " " (espace) est remplacé par le séparateur de milliers
  • "," (virgule) est remplacé par le séparateur décimal
  • "$" est remplacé par le symbole monétaire (il est possible d'écrire "$$" pour ne pas avoir cette substitution)
AndroidJava Les masques de saisie personnalisés ne sont pas supportés.
3. Masques de saisie personnalisés spécifiques
  • Utilisation du pourcentage % :
    Attention : Jusqu'à la version 90028, la valeur affectée au champ par programmation était affichée telle quelle, suivie du caractère %.
    Depuis la version 90033, la valeur affectée par programmation au champ est multipliée par 100 et le caractère "%" est affiché. Pour retrouver le fonctionnement des versions précédentes, il est possible d'écrire "%%" pour afficher le caractère % sans multiplier la valeur par 100.
    Exemple :
    • Affectation du champ par programmation :
      SAI_Saisie1..MasqueSaisie = "999,9%"
      SAI_Saisie1 = 0.562 // Affiche 56,2 %

      SAI_Saisie1..MasqueSaisie = "999,9%%"
      SAI_Saisie1 = 0.562 // Affiche 0,562 %
    • Saisie dans le champ par l'utilisateur :
      • Masque 99.99%, valeur saisie : 19.6, valeur affichée : 19,6%, valeur manipulée par programmation : 0,196.
      • Masque 99.99%%, valeur saisie : 19.6, valeur affichée : 19,6%, valeur manipulée par programmation : 19.6.
  • Utilisation des parenthèses : affichage des nombres négatifs.
    Exemple :
    SAI_Saisie1..MasqueSaisie = "(999 999)"
    SAI_Saisie1 = -1234      // Affiche (1 234)
    SAI_Saisie1 = 1234       // Affiche 1 234
  • Utilisation du signe - en fin de chaîne : affichage des nombres négatifs (il est possible d'écrire "--" pour afficher le signe - en fin de chaîne).
    Exemple :
    SAI_Saisie1..MasqueSaisie = "999 999 -"
    SAI_Saisie1 = -1234      // Affiche 1 234-
  • Masque de saisie multiple : masque de saisie permettant de définir le format des positifs, le format des négatifs, la valeur si 0 est utilisée, la valeur si NULL est utilisée. La syntaxe utilisée est la suivante :
    <Format des positifs>;<Format des négatifs>;<Valeur si 0>;<Valeur si NULL>

    Exemple :
    SAI_Saisie1..MasqueSaisie = "999 999;-999 999;0;<NULL>"
    SAI_Saisie1 = -1234      // Affiche - 1 234

    Remarque : Il est possible de spécifier une couleur en utilisant [<Couleur>] à côté du masque voulu. <Couleur> peut correspondre :
    • à une des constantes suivantes : Rouge, Vert, Bleu, Noir, Blanc, Jaune, Orange
    • à une valeur hexadécimale en utilisant le format "#BBVVRR".
      Exemple :
      SAI_Saisie1..MasqueSaisie = "999 999;-999 999[Rouge];0;<NULL>"
      SAI_Saisie1 = -1234      // Affiche - 1 234 en rouge

      SAI_Saisie1..MasqueSaisie = "999 999;-999 999[ #FF0000];0;<NULL>"
      SAI_Saisie1 = -1234      // Affiche - 1 234 en bleu

      Note : La couleur spécifiée dans le masque de saisie est prioritaire sur la propriété ..Couleur. Elle est ignorée si le champ est grisé.
Remarques :
  • Pour que le nombre saisi soit complété à gauche par des zéros, utilisez le caractère "0" à gauche du masque. Par exemple : "099.999,99".
  • Pour que la partie décimale du nombre saisi soit complétée par des zéros, utilisez le caractère "9" placé à droite de la virgule. Par exemple, en utilisant le masque "9999,99000", le nombre 12 est affiché "12,00" et non pas "12,00000".
    En revanche, le nombre "12,368" est correctement affiché : sa valeur est préservée, sans être tronquée ni arrondie.
  • Pour forcer les signes, utilisez le caractère "+" à gauche. Par exemple : "+9999".
  • AndroidJava Les masques de saisie personnalisés ne sont pas supportés.
  • Versions 18 et supérieures
    WINDEVWindows Mobile Il est également possible de spécifier des masques de saisie hexadécimal (entre 0xF et 0xFFFFFFFFFFFFFFFFF).
    Nouveauté 18
    WINDEVWindows Mobile Il est également possible de spécifier des masques de saisie hexadécimal (entre 0xF et 0xFFFFFFFFFFFFFFFFF).
    WINDEVWindows Mobile Il est également possible de spécifier des masques de saisie hexadécimal (entre 0xF et 0xFFFFFFFFFFFFFFFFF).

Champs de type Monétaire

Les masques de saisie sont du même type que les masques numériques. La différence se situe dans la précision : les monétaires ont 17 chiffres significatifs pour la partie entière et 6 décimales maximum.
Par exemple : "99 999 999 999 999 999,999999".
Versions 17 et supérieures
Remarque : Un masque prédéfini peut également être utilisé pour les champs de type Monétaire :
Versions 17 et supérieures
maskMonétaireSystème
Nouveauté 17
maskMonétaireSystème
maskMonétaireSystème
Masque monétaire utilisé par le système. Correspond au masque sélectionné dans les paramètres régionaux système ("Options régionales" dans le panneau de configuration).
Nouveauté 17
Remarque : Un masque prédéfini peut également être utilisé pour les champs de type Monétaire :
Versions 17 et supérieures
maskMonétaireSystème
Nouveauté 17
maskMonétaireSystème
maskMonétaireSystème
Masque monétaire utilisé par le système. Correspond au masque sélectionné dans les paramètres régionaux système ("Options régionales" dans le panneau de configuration).
Remarque : Un masque prédéfini peut également être utilisé pour les champs de type Monétaire :
Versions 17 et supérieures
maskMonétaireSystème
Nouveauté 17
maskMonétaireSystème
maskMonétaireSystème
Masque monétaire utilisé par le système. Correspond au masque sélectionné dans les paramètres régionaux système ("Options régionales" dans le panneau de configuration).

Champs de type Monétaire + Euro

Les masques de saisie sont du même type que les masques monétaires. Il est possible d'ajouter le caractère dollar ("$") dans le masque pour afficher la devise en cours.
Par exemple : "999,99 $" affichera "250,25 F" si la devise en cours est le franc.

Champs de type Date

Les masques de saisie pour les champs de type Date sont :
  • "JJ/MM/AAAA"
  • "JJ/MM/AA"
  • Versions 16 et supérieures
    "JJJ JJ"
    Nouveauté 16
    "JJJ JJ"
    "JJJ JJ"
  • "MM/JJ/AAAA"
  • "MM/JJ/AA"
  • "AAAA/MM/JJ"
  • "AA/MM/JJ"
  • "JJ/MM/AAAA HH:mm:SS"
  • "MM/JJ/AAAA HH:mm:SS"
  • "JJ/MM/AAAA HH:mm:SS:CCC"
  • "MM/JJ/AAAA HH:mm:SS:CCC"
  • "JJJJ JJ MMMM AAAA"
  • Versions 16 et supérieures
    "Jjjj JJ Mmmm AAAA"
    Nouveauté 16
    "Jjjj JJ Mmmm AAAA"
    "Jjjj JJ Mmmm AAAA"
  • Versions 16 et supérieures
    "Jjjj JJ Mmm AAAA"
    Nouveauté 16
    "Jjjj JJ Mmm AAAA"
    "Jjjj JJ Mmm AAAA"
  • JJ (correspondant au jour de la semaine en chiffres, par exemple : 12)
  • "JJJJ" (jour correspondant de la semaine, par exemple "Jeudi"). La casse utilisée dépend des options linguistiques du projet.
  • Versions 16 et supérieures
    "Jjjj" (correspondant au jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "Jjjj" (correspondant au jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
    "Jjjj" (correspondant au jour de la semaine avec la première lettre forcée en majuscule, par exemple : Lundi)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    "jjjj" (correspondant au jour de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "jjjj" (correspondant au jour de la semaine avec la première lettre forcée en minuscule, par exemple : lundi)
    Java Cette notation n'est pas disponible.
    "jjjj" (correspondant au jour 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"). La casse utilisée dépend des options linguistiques du projet.
  • Versions 16 et supérieures
    "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.
    Nouveauté 16
    "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 majuscule, par exemple : Lun)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    "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.
    Nouveauté 16
    "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.
    "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.
  • MM (mois en chiffres, par exemple : 12)
  • "MMMM" (mois en toute lettre, par exemple "Janvier"). La casse utilisée dépend des options linguistiques du projet.
  • Versions 16 et supérieures
    "Mmmm" (mois en toutes lettres avec la première lettre forcée en majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "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 majuscule, par exemple : Janvier)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    "mmmm" (mois en toutes lettre avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "mmmm" (mois en toutes lettre avec la première lettre forcée en minuscule, par exemple : janvier)
    Java Cette notation n'est pas disponible.
    "mmmm" (mois en toutes lettre 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"). La casse utilisée dépend des options linguistiques du projet.
  • Versions 16 et supérieures
    "Mmm" (abréviation du mois avec la première lettre forcée en majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "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 majuscule, par exemple : Jan)
    Java Cette notation n'est pas disponible.
  • Versions 16 et supérieures
    "mmm" (abréviation du mois avec la première lettre forcée en minuscule, par exemple : jan)
    Java Cette notation n'est pas disponible.
    Nouveauté 16
    "mmm" (abréviation du mois avec la première lettre forcée en minuscule, 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.
  • "AAAA" (l'année sur quatre chiffres, par exemple "2001")
  • "AA" (deux derniers chiffres de l'année, par exemple "01")
  • 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).La date définie par le projet dépend du format de date sélectionné dans les paramètres de la langue du projet :
    • sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
    • affichez l'onglet "Langues", puis options linguistiques concernant la date.
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".
AndroidJava Les masques de saisie personnalisés ne sont pas supportés.

Champs de type Heure

Les masques de saisie pour les champs de types heure sont :
  • "HH:MM"
  • "HH h MM"
  • "HH:MM:SS"
  • "HH:MM:SS AM" : Permet de gérer l'heure au format AM/PM.
  • "HH:MM:SS:CC"
  • le masque prédéfini correspondant à l'heure système. L'heure système dépend du masque sélectionné dans les paramètres régionaux système ("Options régionales" dans le panneau de configuration).
    Versions 17 et supérieures
    maskHeureSystème
    Nouveauté 17
    maskHeureSystème
    maskHeureSystème
    Masque utilisé par le système pour l'heure.

Champs de type DateHeure

Pour spécifier un masque de saisie de type DateHeure, il est nécessaire de :
  1. Passer le type du champ (ou de la colonne de table) en type Date (onglet "Détail" de la fenêtre de description du champ ou de la colonne).
  2. Modifier le masque de saisie de ce champ ou de cette colonne (onglet "Détail" de la fenêtre de description du champ ou de la colonne, ou propriété ..MasqueSaisie).

Champs de type Durée

Les éléments suivants peuvent être utilisés pour définir un masque personnalisé (attention, il est nécessaire de respecter la casse). Pour présenter les masques personnalisés, nous allons prendre une durée égale à 0 jour 04 heures 15 minutes 03 secondes et 412 millièmes de seconde :
  • +1 : seule l'unité la plus significative sera affichée (dans notre exemple, seul le nombre d'heures sera affiché).
  • +2 : seules les deux unités les plus significatives seront affichées (dans notre exemple, seuls le nombre d'heures et le nombre de minutes seront affichés).
    Il est également possible de spécifier '+3' ou '+4' pour afficher uniquement les trois ou les quatre unités les plus significatives.
  • J : le nombre de jours sera affiché si ce nombre est supérieur à 0 (dans notre exemple, le nombre de jours ne sera pas affiché).
  • H : le nombre d'heures sera affiché si ce nombre ou le nombre de jours est supérieur à 0. Si ce nombre est composé d'un seul chiffre, seul ce chiffre sera affiché (dans notre exemple, le nombre d'heures sera '4').
  • HH : le nombre d'heures sera affiché si ce nombre ou le nombre de jours est supérieur à 0. Si ce nombre est composé d'un seul chiffre, ce chiffre sera précédé du chiffre '0' (dans notre exemple, le nombre d'heures sera '04').
  • M : le nombre de minutes sera affiché si ce nombre ou le nombre d'une durée supérieure (nombre de jours ou d'heures) est supérieur à 0. Si ce nombre est composé d'un seul chiffre, seul ce chiffre sera affiché (dans notre exemple, le nombre de minutes sera '15').
  • MM : le nombre de minutes sera affiché si ce nombre ou le nombre d'une durée supérieure (nombre de jours ou d'heures) est supérieur à 0. Si ce nombre est composé d'un seul chiffre, ce chiffre sera précédé du chiffre '0' (dans notre exemple, le nombre de minutes sera '15').
  • S : le nombre de secondes sera affiché si ce nombre ou le nombre d'une durée supérieure (nombre de jours, d'heures ou de minutes) est supérieur à 0. Si ce nombre est composé d'un seul chiffre, seul ce chiffre sera affiché (dans notre exemple, le nombre de secondes sera '3').
  • SS : le nombre de secondes sera affiché si ce nombre ou le nombre d'une durée supérieure (nombre de jours, d'heures ou de minutes) est supérieur à 0. Si ce nombre est composé d'un seul chiffre, ce chiffre sera précédé du chiffre '0' (dans notre exemple, le nombre de secondes sera '03').
  • CC : le nombre de centièmes de seconde sera affiché (dans notre exemple, le nombre de centièmes de seconde sera '41').
  • CCC : le nombre de millièmes de seconde sera affiché (dans notre exemple, le nombre de millièmes de seconde sera '412').
Remarque : Si le séparateur correspond au caractère ":", la lettre correspondant à l'unité la plus significative sera ajoutée (lettre 'h' pour heure, 'm' pour minute, 's' pour seconde, 'cs' pour centièmes de seconde et 'ms' pour millièmes de seconde).
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPad

Champs de type Texte sous l'éditeur d'états

Les masques définis sous l'éditeur d'états sont les suivants (onglet "Général" de la description du champ) :
maskMajusTout en majuscules.
maskMinusTout en minuscules.
maskPMajusPremière lettre en majuscule.
WINDEVWINDEV MobileWindows MobileJavaCode Utilisateur (MCU)

Champs de type Texte sous l'éditeur de fenêtres

  • Les masques prédéfinis
    Ces masques sont définis sous l'éditeur de fenêtres (onglet "Général" de la description du champ).
    maskAAlphaNUmLettre, puis lettres + chiffres.
    maskAAlphaNumMajusLettre en majuscule, puis lettres en majuscules + chiffres.
    maskAdresseIPv6Adresses IP au format IPV6 de type : aaaa :bbbb :cccc :dddd :eeee :ffff :gggg :hhhh :iiii :jjjj
    maskAdresseIPAdresse IP au format IPV4 (exemple : 192.168.2.3).
    maskAdresseMACAdresse MAC au format "aa:bb:cc:dd:ee:ff".
    maskAlphaLettres.
    maskAlphaMajusLettres en majuscules.
    maskAlphaNumLettres + chiffres.
    maskAlphaNumMajusLettres en majuscules + chiffres.
    maskAucunPas de masque de saisie.
    maskCodePostalCode postal français (y compris les DOM) : nombre sur 5 chiffres.
    maskCodePostalAllemagneCode postal allemand.
    maskCodePostalAustralieCode postal australien.
    maskCodePostalAutricheCode postal autrichien.
    maskCodePostalBelgiqueCode postal belge.
    maskCodePostalBrésilCode postal brésilien.
    maskCodePostalCanadaCode postal canadien.
    maskCodePostalEspagneCode postal espagnol.
    maskCodePostalGrèceCode postal grec.
    maskCodePostalItalieCode postal italien.
    maskCodePostalPaysBasCode postal néerlandais.
    maskCodePostalPortugalCode postal portugais.
    maskCodePostalSingapourCode postal singapourien.
    maskCodePostalSuisseCode postal suisse.
    maskCodePostalUKCode postal britannique.
    maskCodePostalUSCode postal américain.
    maskEmailAdresse email.
    maskEmailMultipleAdresses emails séparées par le caractère ";".
    maskEmailRFC2822Adresse email vérifiant la syntaxe définie dans la RFC2822 et vérifiant le top level domain en sortie de champ.
    maskEmailRFC2822MultipleAdresses email séparées par le caractère ";". Ces adresses emails vérifient la syntaxe définie dans la RFC2822 et le top level domain en sortie de champ.
    maskFichierSansRepNom de fichier (sans ses répertoires).
    maskIDPersonne_AustralieNuméro de sécurité social australien (Tax File Number - TFN).
    maskIDPersonne_BelgiqueNuméro de sécurité social belge (National number).
    maskIDPersonne_BrésilNuméro de sécurité social brésilien (Cadastro de Pessoas fisicas).
    maskIDPersonne_CanadaNuméro de sécurité social canadien (Social insurance number).
    maskIDPersonne_EspagneNuméro de sécurité social espagnol (Numero de identificacion de Extranjeros).
    maskIDPersonne_GrèceNuméro de sécurité social grec (Identity card).
    maskIDPersonne_ItalieNuméro de sécurité social italien (Codice fiscale).
    maskIDPersonne_PaysBasNuméro de sécurité social néerlandais (Sofinummer).
    maskIDPersonne_SingapourNuméro de sécurité social singapourien (National Registration Identity Card).
    maskIDPersonne_UKNuméro de sécurité social britannique (National Insurance Number).
    maskIDPersonne_USNuméro de sécurité social américain (Social Security Number).
    maskINSEENuméro INSEE.
    maskINSEECléNuméro INSEE + clé.
    maskISBN10Numéro ISBN sur 10 chiffres.
    maskISBN13Numéro ISBN sur 13 chiffres.
    maskMajusTout en majuscules.
    maskMinusTout en minuscules.
    maskNombreRomainNombre romain (par exemple : MCMLXXIV).
    maskNomFicNom et chemin de fichier.
    maskNumChiffres.
    maskNuméroCarteAmericanExpressNuméro de carte bancaire du réseau American Express sur 15 chiffres.
    maskNuméroCarteMasterCardNuméro de carte bancaire du réseau MasterCard sur 16 chiffres.
    maskNuméroCarteVisaNuméro de carte bancaire du réseau Visa sur 16 chiffres.
    maskNuméroCompteBancaireNuméro de compte bancaire selon la norme IBAN : deux lettres (code pays) + deux chiffres (clé de contrôle) + 11 à 30 chiffres/lettres.
    maskNumPlusChiffres, '+', ' ', '.', '-', ','
    maskPatronymeLettres + Chiffres + Espace + Apostrophe + Tiret.
    maskPatronymeMajusculeLettres Majuscules + Chiffres + Espace + Apostrophe + Tiret.
    maskPMajusPremière lettre en majuscule.
    maskRIBNuméro de RIB d'un compte.
    maskSIRENNuméro de SIREN d'une société : nombre de 9 chiffres constitué de huit chiffres + un code de contrôle (sur un chiffre) calculé selon l'algorithme de Luhn.
    maskSIRETNuméro de SIRET d'un établissement : c'est un numéro de SIREN suivi de 4 chiffres + un code de contrôle (sur un chiffre) calculé selon l'algorithme de Luhn.
    maskTelNuméro de téléphone
    Versions 20 et supérieures
    maskTelBelgique
    Nouveauté 20
    maskTelBelgique
    maskTelBelgique
    Numéro de téléphone au format Belge (avec gestion des indicatifs, des numéros nationaux et internationaux).
    Android Cette constante n'est pas disponible.
    Versions 20 et supérieures
    maskTelCanada
    Nouveauté 20
    maskTelCanada
    maskTelCanada
    Numéro de téléphone au format Canadien ou Américain (XXX CCC-CCCC ou +1 XXX CCC-CCCC où XXX correspond au code régional et CCC-CCCC correspond au numéro local).
    Android Cette constante n'est pas disponible.
    maskTelFranceNuméro de téléphone au format Français (10 chiffres, regroupés par 2). Par exemple : "04 67 69 40 23" ou "36 99".
    Versions 20 et supérieures
    maskTelSuisse
    Nouveauté 20
    maskTelSuisse
    maskTelSuisse
    Numéro de téléphone au format Suisse (0CC CCC CC CC ou +41 CC CCC CC CC).
    Android Cette constante n'est pas disponible.
  • Les masques personnalisés
    Ces masques personnalisés sont décrits à l'aide des caractères suivants :
    • "9" : Chiffre isolé
    • "C" : Chiffre ou espace
    • "L" (la lettre L en majuscule) : Lettre majuscule
    • "l" (la lettre L en minuscule) : Lettre minuscule
    • "A" : Caractère alphanumérique majuscule
    • "a" : Caractère alphanumérique minuscule
    • "?" : Tout caractère
Tout autre caractère est reproduit tel quel. Il n'y a donc jamais de masque incorrect.

Remarque : Il est possible de décrire un masque numérique dans un champ texte. La valeur récupérée sera une chaîne de caractères numériques et non pas une valeur numérique.
Par exemple : Pour une plaque d'immatriculation : CCCC LL 9A (9A pour les départements 2A et 2B).
WINDEVWINDEV MobileWindows MobileJavaCode Utilisateur (MCU)

Champs de type Jauge

Dans un champ de type Jauge, le masque de saisie permet de définir le formatage du texte affiché dans la jauge. Par défaut, le masque utilisé est "999,9 %". Il est possible d'utiliser les masques personnalisés disponibles pour un champ de type Texte.

Type de masque de saisie

Attention : Le changement d'un masque peut se faire uniquement avec un masque de même type. Par exemple, il est impossible de remplacer le masque de saisie d'un champ de type DATE par un masque de saisie de type HEURE.
L'affectation d'un masque de saisie incorrect entraîne un message d'erreur.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileJavaAjaxCode Utilisateur (MCU)

Expressions régulières dans les masques de saisie

Les expressions régulières utilisées dans cette propriété ne doivent pas être celles utilisées dans la fonction VérifieExpressionRégulière.
Dans les masques de saisie, les expressions régulières permettent d'empêcher la saisie de certains caractères ou d'une séquence de caractères.
Dans la fonction VérifieExpressionRégulière, les expressions régulières permettent de vérifier si une chaîne est conforme à un format.
Exemple : Vérification que la chaîne T1 contient une lettre et un chiffre :
  • avec la fonction VérifieExpressionRégulière : l'expression régulière utilisée est [A-Za-z][0-9]
  • avec ..MasqueSaisie : l'expression régulière utilisée est [A-Za-z]{0,1}[0-9]{0,1}
Versions 20 et supérieures
WINDEV

Champ Tableur

Le masque d'une cellule d'un champ Tableur peut être défini par la fonction TableurTypeEtMasqueSélection. La propriété ..MasqueSaisie permet de modifier le masque de saisie défini (le type de la cellule n'est pas modifié).
Nouveauté 20
WINDEV

Champ Tableur

Le masque d'une cellule d'un champ Tableur peut être défini par la fonction TableurTypeEtMasqueSélection. La propriété ..MasqueSaisie permet de modifier le masque de saisie défini (le type de la cellule n'est pas modifié).
WINDEV

Champ Tableur

Le masque d'une cellule d'un champ Tableur peut être défini par la fonction TableurTypeEtMasqueSélection. La propriété ..MasqueSaisie permet de modifier le masque de saisie défini (le type de la cellule n'est pas modifié).

Limites

WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileUniversal Windows 10 AppiPhone/iPad Dans un état, la propriété ..MasqueSaisie peut être utilisée uniquement sur :
  • un champ calculé,
  • un champ prédéfini,
  • un champ Rubrique.un champ Libellé.
WINDEVWINDEV Mobile Dans une fenêtre, la propriété ..MasqueSaisie s'applique uniquement aux :
  • champs de saisie,
  • colonnes de table,
  • Versions 17 et supérieures
    WINDEV colonnes de table affichées par une combo.
    Nouveauté 17
    WINDEV colonnes de table affichées par une combo.
    WINDEV colonnes de table affichées par une combo.
  • combos en saisie,
  • groupes de champs de saisie,
  • cellules de tables.
WEBDEV - Code Serveur Cette propriété est disponible uniquement en Lecture / Ecriture pour les champs d'un état. Pour les champs d'une page, cette propriété n'est pas disponible.
Java En Java, la propriété ..MasqueSaisie s'applique uniquement aux éléments suivants :
  • Champ de saisie.
  • Combo.
  • Colonne de table.
AndroidJava Les masques de saisie personnalisés ne sont pas supportés.
Liste des exemples associés :
Les expressions régulières Exemples unitaires (WINDEV) : Les expressions régulières
[ + ] Utilisation des expressions régulières avec WINDEV.
Deux types d'utilisation des expressions régulières sont présentés :
- vérification du format d'une saisie
- extraction des différents éléments respectant le format d'une saisie.
Cet exemple montre également comment rechercher un mot dans une chaîne, avec possiblité de ne pas prendre en compte la casse, le début ou la fin d'une chaîne, mais également de ne pas tenir compte des espaces (n'importe où dans la chaîne, y compris dans le mot recherché)
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
Les expressions régulières Exemples unitaires (WINDEV Mobile) : Les expressions régulières
[ + ] Utilisation des expressions régulières avec WINDEV Mobile.
Il montre 2 types d'utilisation des expressions régulières :
- vérifier le format d'une saisie
- extraire les différents éléments respectant le format d'une saisie.
Cet exemple montre également comment rechercher un mot dans une chaîne, avec possiblité de ne pas prendre en compte la casse, le début ou la fin d'une chaîne, mais également de ne pas tenir compte des espaces (n'importe où dans la chaîne, y compris dans le mot recherché)
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Attention à la RFC 2822
Pour information, le masque RFC2822 m'a posé un problème inattendu.
On ne peut avoir que 22 caractères avant le @robase.
Bowen
16 mar. 2010