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 de saisie et d'affichage par défaut
  • Dans une fenêtre ou une page
  • Dans un état
  • Masques de saisie personnalisés
  • Champs de type Monétaire
  • Différences entre le type Numérique et le type Monétaire
  • Champ de type Monétaire + Euro
  • Remarques
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 imprimés dans les champs d'un état.
Masque de saisie et d'affichage par défaut

Dans une fenêtre ou une page

Par défaut, le masque de saisie correspond à celui défini pour le projet : les informations définies dans les paramètres de gestion des numériques, monétaires, ... 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 : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
Les masques de saisie proposés par défaut sont les suivants :
  • Numérique défini par le projet.
  • Taille de fichier.
  • Pourcentage.

Dans un état

Par défaut, le masque de saisie :
  • 999 999,99 est associé à un champ de type numérique.
  • +99 999 999,99 est associé à un champ de type monétaire.
  • +999 999,99 $ est associé à un champ de type monétaire + Euro.
Masques de saisie personnalisés
Pour les champs de type Numérique et de type Monétaire, les masques de saisie / d'affichage se définissent à l'aide des caractères suivants :
  • '9' : chiffre,
  • '.' : point,
  • ',' : virgule,
  • '+' : signe plus (pour autoriser les nombres signés),
  • '-' : signe moins utilisé en fin de chaîne pour afficher les nombres négatifs. Pour afficher le signe "-" en fin de chaîne que le nombre soit positif ou négatif, il suffit d'indiquer "--".
  • ' ' : espace,
  • '0' : à gauche du masque, pour que le nombre soit automatiquement complété par des zéros (à gauche),
  • '%' : pourcentage. La valeur affichée (affectée par programmation par exemple) est multipliée par 100 et le sigle % est affiché.
    Pour afficher le signe % sans multiplier par 100, il suffit de doubler le sigle % (exemple : "99.99%%").
    Important : si dans les versions précédentes de WINDEV 9, WEBDEV 9 ou WINDEV Mobile 9 (Version 90028 ou antérieures) vous utilisiez le caractère % dans vos masques de saisie, celui-ci est automatiquement doublé pour compatibilité.
    Exemple :
    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.
  • '()' : parenthèses, pour l'affichage des nombres négatifs.
Format personnalisé avancé : Il est également possible de définir en même temps :
  • le format des chiffres positifs
  • le format des chiffres négatifs
  • la valeur si 0
  • la valeur si NULL
Le format de ce type de maque de saisie / d'affichage est le suivant :
<Format des positif>;<Format des négatifs>;<Valeur si 0>;<Valeur si NULL>
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".
Champs de type Monétaire

Différences entre le type Numérique et le type Monétaire

Les masques proposés pour les champs de type Monétaire 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.

Champ de type Monétaire + Euro

Il est possible d'ajouter le caractère dollar ("$") dans le masque pour afficher :
  • soit le sigle '' si la devise en cours est l'Euro.
  • soit le libellé de la devise (défini dans la table des changes grâce à la fonction eInitDevise) si la devise est différente de l'Euro.
Par exemple : Le masque '999,99 $' affichera '250,25 ' si la devise en cours est l'Euro et '250,25 GBP' si la devise en cours est la Livre Sterling.
Remarque : Il est possible d'écrire "$$" pour forcer l'utilisation du sigle $.

Remarques

  • La valeur "++++" sera affichée dans le champ si les conditions suivantes sont réunies :
    • affectation par programmation.
    • nombre de chiffres de la partie entière supérieur au nombre de chiffres de la partie entière du masque.
    Par exemple, si le masque est '99.999' et si la valeur affectée par programmation est '123456', la valeur "++++" sera affichée dans le champ.
  • La partie décimale sera arrondie si les conditions suivantes sont réunies :
    • affectation par programmation.
    • nombre de chiffres de la partie décimale supérieur au nombre de chiffres de la partie décimale du masque.
    Par exemple, si le masque est '99.999,99' et si la valeur affectée par programmation est '12345,159', la valeur "12345,16" sera affichée dans le champ.
Liste des exemples associés :
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
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/03/2023

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