• Champ de saisie,
• Champ Combo (avec ou sans saisie),
• Champ Interrupteur et champ Sélecteur,
• Champ Notation.

• Via le texte d'indication (si le champ est vide),
• En modifiant le style du champ,
• En affichant le picto de saisie obligatoire,
• En affichant le texte d'explication.

• saisie obligatoire bloquante,
• saisie obligatoire non bloquante.

Saisie obligatoire bloquante

1. Affichez la fenêtre de description du champ.
2. Dans l'onglet "Détail", dans la zone "Saisie obligatoire / invalide" :
   
   • Cochez l'option "Saisie obligatoire".
   • Sélectionnez l'option "Bloquer la sortie du champ".
   Remarque : il est possible de configurer les options d'indication de la saisie obligatoire via le bouton "Textes et options d'affichage".
3. Validez la fenêtre de description du champ.

Saisie obligatoire non bloquante

1. Affichez la fenêtre de description du champ.
2. Dans l'onglet "Détail", dans la zone "Saisie obligatoire / invalide" :
   
   • Cochez l'option "Saisie obligatoire".
   • Sélectionnez l'option "Utiliser SaisieInvalideDétecte".
   Remarque : il est possible de configurer les options d'indication de la saisie obligatoire via le bouton "Textes et options d'affichage".
3. Validez la fenêtre de description du champ.
4. Dans le code de validation de la fenêtre (par exemple bouton d'ajout dans la base de données), utilisez la fonction SaisieInvalideDétecte. Cette fonction permet de vérifier si tous les champs de saisie obligatoires de la fenêtre en cours ont bien été renseignés. Selon les options définies via le bouton "Textes et options d'affichage", les champs posant problème sont mis en évidence.

Textes et options d'affichage : paramètres concernant la saisie obligatoire

• l'affichage d'une indication : permet d'indiquer que la saisie est obligatoire lorsque la saisie est vide AVANT l'exécution de la fonction SaisieInvalideDétecte.
• l'affichage d'une erreur : permet d'indiquer que la saisie est obligatoire lorsque la saisie est vide APRES l'exécution de la fonction SaisieInvalideDétecte.

• Modifier le style du champ : Cette option modifie le style du champ. Le style utilisé pour l'indication et pour l'erreur est défini dans l'onglet "Style" du champ.
  
• Afficher le picto de saisie obligatoire : Cette option affiche un picto spécifique dans le champ. Le picto utilisé ainsi que sa position par rapport à la zone de saisie est défini dans l'onglet "Style" du champ (élément "Saisie obligatoire (indication/erreur) : Explication et picto", bouton "Picto".
  
  Si cette option est choisie, il est possible de saisir le texte d'explication. Ce texte sera affiché au survol du champ et lors du clic sur le picto. Remarque : Si le texte d'explication n'est pas spécifié, un texte d'explication par défaut sera affiché.
• Afficher le texte d'explication : Affiche le texte d'explication sous le champ. Si le texte d'explication n'est pas spécifié, un texte d'explication par défaut sera affiché. Attention : Cette option modifie l'interface. Si cette option est sélectionnée, le texte d'indication choisi est affiché directement sous le champ dans la fenêtre en édition. Il peut être nécessaire d'adapter l'interface pour que le champ soit affiché entièrement.

Mettre en place la vérification de la saisie invalide

1. Définissez une variable de type MasqueDeSaisie correspondant au masque de saisie à appliquer au champ.
   Attention : Pensez à définir la procédure WLangage appelée par la propriété VérifieSiSaisieValide de la variable MasqueDeSaisie. En effet, cette procédure sera automatiquement appelée lors de l'utilisation de la fonction SaisieInvalideDétecte pour déterminer si le texte saisi est valide.
2. Définissez dans le code du champ le masque de saisie à utiliser, grâce à la propriété MasqueSaisie.
3. Affichez la fenêtre de description du champ.
4. Dans l'onglet "Détail", dans la zone "Saisie obligatoire / invalide" :
   
   • Sélectionnez l'option "Utiliser SaisieInvalideDétecte".
   • Configurez les options d'indication de la saisie obligatoire via le bouton "Textes et options d'affichage".
5. Validez la fenêtre de description du champ.
6. Dans le code de validation de la fenêtre (par exemple bouton d'ajout dans la base de données), utilisez la fonction SaisieInvalideDétecte. Cette fonction permet de vérifier les problèmes de saisie invalide et de saisie obligatoire.

Textes et options d'affichage : paramètres concernant la saisie invalide

• Modifier le style du champ : Modifie le style du champ. Le style utilisé pour les différents éléments de la saisie invalide est défini dans l'onglet "Style" du champ.
  
• Afficher le picto de saisie obligatoire : Affiche un picto spécifique dans le champ. Le picto utilisé ainsi que sa position par rapport à la zone de saisie est défini dans l'onglet "Style" du champ (élément "Saisie invalide : Explication et picto", bouton "Picto".
  
  Si cette option est choisie, il est possible de saisir le texte d'explication. Ce texte sera affiché au survol du champ et lors du clic sur le picto. Remarque : Si le texte d'explication n'est pas spécifié, un texte d'explication par défaut sera affiché.
• Afficher le texte d'explication : Affiche le texte d'explication sous le champ. Si le texte d'explication n'est pas spécifié, un texte d'explication par défaut sera affiché. Attention : Cette option modifie l'interface. Si cette option est sélectionnée, le texte d'indication choisi est affiché directement sous le champ dans la fenêtre en édition. Il peut être nécessaire d'adapter l'interface pour que le champ soit affiché entièrement.

Exemple

• L'événement "Sortie" du champ contient le code suivant :
  
  MoiMême.MasqueSaisie = gMasqueTéléphone
  
• Le code d'initialisation du projet contient le code suivant permettant de définir la variable de type MasqueDeSaisie :
  
  gsMasqueTéléphone est une chaîne = "99 99 99 99 99"
  gMasqueTéléphone est un MasqueDeSaisie
   
  gMasqueTéléphone.VérifieSiSaisieValide = VerifieSiSaisieValide
  gMasqueTéléphone.ValideEnSaisie = ValideEnSaisie
  gMasqueTéléphone.FormateEnSaisie = FormateEnSaisie
  gMasqueTéléphone.FormateEnSortie = FormateEnSortie
  gMasqueTéléphone.FormateEnEntrée = FormateEnEntrée
  gMasqueTéléphone.FormateEnAffectation = FormateEnAffectation
   
  PROCÉDURE INTERNE VerifieSiSaisieValide(sTexte est une chaîne) : booléen
  RENVOYER VérifieExpressionRégulière(sTexte, "[0-9 ]*") _ET_
  Taille(ChaîneFormate(sTexte, ccSansEspaceIntérieur)) = 10
  FIN
   
  PROCÉDURE INTERNE FormateEnSaisie(LOCAL sTexteAvant est une chaîne,
  LOCAL nCurseurAvant est un entier,
  LOCAL nFinCurseurAvant est un entier, sTexteApres est une chaîne,
  nCurseurApres est un entier,
  nFinCurseurApres est un entier)
  SI Taille(sTexteAvant) > Taille(sTexteApres) ALORS RETOUR
  //Ne rien faire si on est en train d'effacer
  // si on est a la fin
  SI nFinCurseurApres = Taille(sTexteApres) + 1 ALORS
  // on met un " " si c'est ce qu'il faut à cette position
  SI Milieu(gsMasqueTéléphone, nFinCurseurApres, 1) = " " ALORS
  sTexteApres += " "
  nFinCurseurApres ++
  nCurseurApres = nFinCurseurApres
  FIN
  FIN
  FIN
   
  PROCÉDURE INTERNE ValideEnSaisie(sTexte chaîne) : booléen
  RENVOYER VérifieExpressionRégulière(sTexte, "[0-9 ]*")
  FIN
   
  PROCÉDURE INTERNE ValideEnSortie(sTexte chaîne) : booléen
  RENVOYER VérifieExpressionRégulière(sTexte, "[0-9 ]*")
  FIN
   
  PROCÉDURE INTERNE FormateEnSortie(sTexte_INOUT est une chaîne)
  FormateChaîneEnNuméroTéléphone(sTexte_INOUT)
  FIN
   
  PROCÉDURE INTERNE FormateEnEntrée(sTexte_INOUT est une chaîne)
  FormateChaîneEnNuméroTéléphone(sTexte_INOUT)
  FIN
  PROCÉDURE INTERNE FormateEnAffectation(sTexte_INOUT est une chaîne)
  FormateChaîneEnNuméroTéléphone(sTexte_INOUT)
  FIN
   
  PROCÉDURE INTERNE FormateChaîneEnNuméroTéléphone(sTexte_INOUT est une chaîne)
  sOut est une chaîne = ""
  sTexte_INOUT = ChaîneFormate(sTexte_INOUT, ccSansEspaceIntérieur + ccSansEspace)
  soit nTexte = 1
  POUR n = 1 _À_ Taille(gsMasqueTéléphone)
  SI nTexte > Taille(sTexte_INOUT) ALORS SORTIR
  SI gsMasqueTéléphone[n] = " " ALORS
  sOut += " "
  SINON
  sOut += sTexte_INOUT[nTexte]
  nTexte ++
  FIN
  FIN
  sTexte_INOUT = sOut
  FIN
  
• Le bouton de vérification contient le code suivant :
  
  SaisieInvalideDétecte()
  

• Propriétés disponibles :
  

  SaisieInvalideBloquante	La propriété SaisieInvalideBloquante permet de savoir s'il est possible ou non de sortir du champ en cas de saisie invalide.
  SaisieObligatoire	La propriété SaisieObligatoire permet de connaître et modifier la caractéristique de saisie obligatoire d'un champ.
  TexteSaisieInvalide	La propriété TexteSaisieInvalide permet de connaître et de définir le texte qui sera affiché si le champ est invalide (masque ou borne).
  TexteSaisieObligatoire	La propriété TexteSaisieObligatoire permet de connaître et de définir le texte qui sera affiché si le champ est vide (avec la propriété SaisieObligatoire activée).
• Fonctions disponibles :
  

  SaisieInvalideAfficheErreur	Affiche une erreur de saisie invalide pour le champ spécifié.
  SaisieInvalideDétecte	Détecte et met en erreur les champs dont la saisie est invalide et /ou obligatoire.
  SaisieInvalideListeChamp	Construit la liste des champs dont la saisie est invalide/obligatoire.