DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs
  • Prise de focus
  • Fonction EcranPremier utilisée avec une fenêtre
  • Evénements exécutés lors de l'utilisation de la fonction EcranPremier
  • Fonctions EcranPremier, DonneFocus et DonneFocusEtRetourUtilisateur
  • Erreur
  • Champ indicé
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éfinit le prochain champ qui sera en saisie dans la fenêtre en cours. Ce champ aura le "focus" : les actions effectuées au clavier par l'utilisateur seront dirigées vers ce champ.
Exemple
// Met la saisie sur le champ "SAI_Saisie2"
EcranPremier(SAI_Saisie2)
// Change le prochain champ en saisie
SI ChampEnCours() <> SAI_Nom ALORS EcranPremier(SAI_Nom)
Syntaxe
EcranPremier([<Champ manipulé> [, <Indice>]])
<Champ manipulé> : Nom de champ optionnel
Nom du champ (y compris colonne d'un champ Table) ou de la fenêtre qui doit être en saisie.
Si ce paramètre correspond à un nom de fenêtre, la fenêtre sera activée et un champ pouvant prendre le focus sera en saisie.
Si ce paramètre correspond à un champ ne pouvant pas prendre le focus (champ invisible, libellé, ...), la saisie commencera au champ suivant selon l'ordre de saisie.
<Indice> : Entier optionnel
Indice pour un champ indicé.
Remarques

Prise de focus

La prise de focus d'un champ est matérialisée différemment selon le type du champ :
  • Curseur clignotant (ou "Caret") pour les champs de saisie.
  • Rectangle pointillé pour les autres types de champs (champs Bouton, Liste, Sélecteur, etc.).
Attention : Tous les types de champs ne peuvent pas prendre le focus (champs de type "Libellé" par exemple).

Fonction EcranPremier utilisée avec une fenêtre

Si le paramètre <Nom du champ> correspond à un nom de fenêtre, la fenêtre est activée. Le champ prenant le focus dans cette fenêtre correspondra :
  • soit au dernier champ précédemment en saisie dans cette fenêtre,
  • soit au premier champ pouvant prendre le focus dans cette fenêtre (si aucune saisie n'a été effectuée précédemment dans cette fenêtre).

Evénements exécutés lors de l'utilisation de la fonction EcranPremier

En règle générale, l'appel de la fonction EcranPremier entraine l'exécution des événements de sortie (du champ ou de la fenêtre en cours) et d'entrée (dans le champ ou la fenêtre spécifié).
Exception à cette règle : Le code de sortie du champ en cours n'est pas exécuté si la fonction EcranPremier est utilisée dans un des événements associés à ce champ.

Fonctions EcranPremier, DonneFocus et DonneFocusEtRetourUtilisateur

Ces fonctions ont un comportement très différent :
  • La fonction DonneFocusEtRetourUtilisateur 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 du champ> ne correspond pas à un champ existant dans la fenêtre en cours.
Etats et RequêtesWindows

Champ indicé

Le paramètre <Indice> permet de spécifier l'indice d'un champ indicé. Il est aussi possible d'utiliser directement le nom du champ indicé. Par exemple :
EcranPremier(SAI_Saisie1, 1) = EcranPremier(SAI_Saisie1[1])
Composante : wd300obj.dll
Version minimum requise
  • Version 9
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