DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion de la saisie invalide
  • Caractéristiques de la vérification/détection des champs dont la saisie est invalide et /ou obligatoire
  • Divers
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
Détecte et met en erreur les champs dont la saisie est invalide et /ou obligatoire.
Exemple
// Evénement Autorisation de fermeture d'une fenêtre
SI SaisieInvalideDétecte() ALORS
RENVOYER Faux
SINON
RENVOYER Vrai
FIN
Syntaxe
<Résultat> = SaisieInvalideDétecte([<Elément manipulé>])
<Résultat> : Booléen
  • Vrai si la saisie est invalide ou obligatoire pour au moins un champ,
  • Faux dans le cas contraire.
<Elément manipulé> : Nom de champ ou nom de fenêtre optionnel
Nom du champ ou de la fenêtre dans le(la)quel(le) la vérification doit être effectuée. Si le champ est un conteneur (champ Onglet, Superchamp, etc.), la vérification sera effectuée en profondeur pour tous les champs de ce conteneur.
Si ce paramètre n'est pas spécifié, la détection est effectuée sur tous les champs de la fenêtre en cours.
Remarques

Caractéristiques de la vérification/détection des champs dont la saisie est invalide et /ou obligatoire

La vérification de la saisie sera effectuée pour les types de champs suivants :
  • Champ Sélecteur/Interrupteur : si l'option de saisie obligatoire a été activée (ou propriété SaisieObligatoire à Vrai), vérifie qu'au moins une option est sélectionnée.
  • Champ Notation : si l'option de saisie obligatoire a été activée (ou propriété SaisieObligatoire à Vrai), vérifie qu'une note a été attribuée.
  • Combo en saisie : si l'option de saisie obligatoire a été activée (ou propriété SaisieObligatoire à Vrai), vérifie qu'une valeur a été saisie ou sélectionnée dans la combo.
    Si un masque de saisie a été utilisé, la fonction vérifie que la saisie est valide pour ce masque.
    Dans le cas de l'utilisation d'un masque personnalisé avec une variable de type MasqueDeSaisie, la vérification est effectuée en exécutant la procédure associée à la propriété VérifieSiSaisieValide de ce masque.
  • Combo sans saisie : si l'option de saisie obligatoire a été activée (ou propriété SaisieObligatoire à Vrai), vérifie qu'une valeur a été sélectionnée dans la combo.
  • Champ de saisie : si l'option de saisie obligatoire a été activée (ou propriété SaisieObligatoire à Vrai), vérifie qu'une valeur a été saisie ou sélectionnée dans le champ.
    Si un masque de saisie a été utilisé, la fonction vérifie que la saisie est valide pour ce masque. Dans le cas de l'utilisation d'un masque personnalisé avec une variable de type MasqueDeSaisie, la vérification est effectuée en exécutant la procédure associée à la propriété VérifieSiSaisieValide de ce masque.
La vérification est effectuée uniquement sur les champs actifs et visibles.

Divers

  • La fonction donne le focus au premier champ détecté selon l'ordre de navigation.
  • Il est possible de personnaliser le mode d'affichage de l'erreur dans la fenêtre de description des champs concernés.
  • L'état en erreur d'un champ sera annulé dès lors que la saisie du champ est modifiée par l'utilisateur ou par programmation.
  • Pour connaitre les champs dont la saisie est invalide/obligatoire sans les passer en erreurs, utilisez la fonction SaisieInvalideListeChamp.
  • Les propriétés TexteSaisieObligatoire et TexteSaisieInvalide permettent de personnaliser les messages d'erreur affichés en cas de saisie invalide/obligatoire.
  • Cas particulier : champ de saisie ou combo avec saisie possédant un masque personnalisé via une variable de type MasqueDeSaisie. Si le champ n'a pas le focus au moment de l'appel de la fonction SaisieInvalideDétecte, le texte affiché dans le champ sera au préalable formaté avec la procédure de la propriété FormateEnEntrée du masque avant de vérifier sa validité.
Classification Métier / UI : Code UI
Composante : wd290obj.dll
Version minimum requise
  • Version 26
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