PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Prise de focus
  • Fonctions EcranPremier, DonneFocus et RepriseSaisie
  • Erreur
  • Fonction RepriseSaisie sur le dernier champ en cours
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Arrête le traitement en cours et force la reprise de saisie dans le champ, la fenêtre ou la page spécifié(e).
WEBDEV - Code Navigateur La fonction RepriseSaisie peut être utilisée dans un événement navigateur (onchange, onclick, etc.), mais elle ne peut pas être utilisée dans une procédure locale ou une procédure globale navigateur.
Exemple
// Si l'utilisateur n'a rien saisi dans le champ
SI SAI_Saisie1 = "" ALORS
// On affiche un message et on remet l'utilisateur en saisie sur le champ
Erreur("Saisissez une valeur")
RepriseSaisie(SAI_Saisie1)
FIN
Syntaxe
RepriseSaisie([<Nom de l'objet>])
<Nom de l'objet> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du champ, de la colonne ou de la fenêtre qui doit prendre le focus (voir Remarques). Si ce paramètre n'est pas spécifié, le focus est donné au champ en cours.
Pour indiquer un champ appartenant à une fenêtre ouverte différente de la fenêtre en cours, <Nom de l'objet> doit être de la forme <Nom de fenêtre>.<Nom du champ>.
WEBDEV - Code Navigateur Nom du champ ou de la page qui doit prendre le focus (voir Remarques). Si ce paramètre n'est pas spécifié, le focus est donné au dernier champ en cours.
Remarques

Prise de focus

La possession du "focus" est matérialisée de différentes manières :
  • Curseur clignotant (ou "Caret") pour les champs de saisie.
  • Rectangle pointillé pour les autres types de champs (boutons, listes, sélecteurs, ...).

Fonctions EcranPremier, DonneFocus et RepriseSaisie

Ces fonctions ont un comportement très différent :
  • La fonction RepriseSaisie arrête le traitement en cours pour forcer la reprise de la saisie dans le champ indiqué.
  • La fonction EcranPremier décrit quel sera le prochain champ ayant la saisie (lorsque le code en cours s'arrêtera et que la saisie reprendra).
  • La fonction DonneFocus arrête le traitement en cours, décrit quel sera le prochain champ ayant la saisie et reprend le traitement en cours.

Erreur

Une erreur du WLangage apparaît si le <Nom de l'objet> ne correspond pas à un champ existant dans la fenêtre ou la page en cours.
WEBDEV - Code NavigateurAjax

Fonction RepriseSaisie sur le dernier champ en cours

La fonction RepriseSaisie utilisée sans paramètre permet de donner le focus au dernier champ en cours. Cette fonction, utilisée par exemple dans le code de sortie d'un champ de saisie, permet de forcer la saisie dans le champ en cours si les informations saisies ne correspondent pas aux informations attendues.
Le champ doit alors être de l'un des types de champs suivants :
  • Champ de saisie.
  • Champ Interrupteur.
  • Champ Sélecteur.
  • Champ Liste.
  • Champ Combo.
  • Champ Zone de clicage.
Si le nom du champ correspond à une chaîne construite, il est nécessaire d'utiliser l'alias du champ (par exemple "AliasChamp"+Num). Dans ce cas, aucune vérification n'est effectuée : des erreurs Javascript peuvent être affichées si le focus est donné à un champ qui n'existe pas.
Rappel : L'alias d'un champ correspond au nom de ce champ dans la page HTML. Pour connaître cet alias :
  • sous l'éditeur de code, utilisez la combinaison de touches Maj + F1.
  • par programmation, utilisez la propriété ..Alias.
Composante : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire